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by Nicholas C. 'hiick.c'' DeMello <editor@mactech.com> 


Crcaiin^ st>fiwarL‘ recfuircs an (kIcI mixture of humility 
and iirrogancc. The art of progntiimiing involves studying eoin[)Iex 
l^haviors, accomplishing tliem with efficient logical processes, and 
expressing tf^ai logic so simply and dearly that even a machine can 
enact it. For stjmeone to consider leaching a hunk of silicon tlie skill 
of piloting an airplane, the subtleties of quitnaim meclianics, or 
even the simple trick of announcing "hello world”... well, a little 
arrogant confidence is lequiied. But ffie lx\st among us Lenifx.T tlieir 
confidence with the realization that there is no profit in reinventing 
the wheel, ffiat we can never foresee all the possible applicaticjns 
of our prcxiuct, and tlial I rugs happen. The outrageous Lx>nfidenc:e 
needed to try something untried and the necessary cxiution required 
to turn that something into reliable and efficient ctxle is epittimizetl 
by the Mac OS and tlie modular, extendible program design 
underlying it. In this i.ssue, MacTech presents a number of articles 
on mtxlular software design and i^lug-in tedmologies. I want to 
inlroduc:e just a few of them here. 

It’s been estimated tliat the lisa project, the precuisor of 
Kxlay’s Macintosh, rcKik over 2tH) man years to accomplish, lisa 
owed significantly to ground breaking work in the design of the 
WIMP (windows, icons, mouse, pointer) GUI develo[>cd at 
Xerox. While the WIMP development at Xerox's Palo Alto 
re.se;jrch center (PAKC) was occurring, the term '‘objea-oriented” 
was being coined in the same faciliiy. 1*ARC dcvelo|x:d ihc 
Smalltalk language — argual.'tly the purest representation of the 
object-oriented ideal — at the same time they were w^orking on 
tlie WIMl^ interface. The innuence of objeci oriented design on 
Xerox's GUI is clear. 11iat same influence affected Lisa and is an 
integral part of today's Mae OS. 

Tlie Madnuxsli operating system w^as broken down into a 
multitude of smaller, sim]:tler goals. Many of these objeetives am 
represented liy independent code mcxlules or mniime librarie.s. By 
I a caking pn>jeeLs dow n into sinifde, .self-contained and 
indejx^ndentJy compiled olijects hugs are isolated and easier Lc 3 
lfx:ate, while project goals become cleancT and easier to define. It 
also makes your pn>jeci atlapiable anti expandable. Consider all the 
powerful tcchnoit jgies, never dreamed ul'hy tJie LLsii engineers, that 
liave I'leen added to the Macintosh c>peiating system. 

Your next project may not be a.s intimidating as writing a 
new operating system, but then it might feel that way. Yon 
probably will apply a modular de.sign to that project, breaking 
the code down into smaller and more manageable pieces 
represented by different c:lasses or code files. But, what if you 
took that a step farther and isolated fundamental logic to a 
separately compiled removable, replaceable plug-in? Not only 
woultl y<HJr nexi update be a little easier, your code base and 


hug space a link smaller, t)ut 1 bet yoirve already started 
thinking about entirely different logic you could offer as a 
second plug-in. Rest assured, if you haven't — one of your 
users will. In this issue, Joe ?:obkiw' describes ihe 
fundamentals of adding a plug-in architecture to your next 
application. By providing a plug-in architecture you, or your 
more creative customers, can expand and adapt your product 
in new and exciting directions. 

Or consider the problem from tlie other side. Perhaps your 
goal c;m best be achievetl by creating new logic for an existing 
application. Tcx>ls like Resr)rcefer, FileMaker Pro, Netscape and 
CtxJeWarrior offer plug-in architectures and therefore opportunitie.s 
to tune these powerful tools to your mexst .specific neecLs. lliey also 
offer opportiiniries in that you can cjuickly create valuable 
companion products lor existing markets. Photoshop is an 
essential tool for giujihic artists, esUiblishing a huge market for 
plug-in companion prfxliuts like Kai’s lYiwer Tools and Alien 
Skin's Eye Candy. To gel an idea of how easy it can be to create a 
jilug-in, take a look at Steve Sheets anide in tliis issue on aafting 
plug-ins for BBEdit — the Swiss army cliainsaw of text editors. 

Modular design isn't only alnxii plug-ins. Most pn>granimcrs 
liave a folder someplace. That folder is filled with snippets and 
example code (a class for implementing a preferences file, a 
linked list code module, or jusi a snippet showing how to spin 
a cursor). Odds are you don’t even read most of liiat code 
anymore, it's just copy and paste — plug and play, lliafs the 
way it should be. Detroit ckxrsn't reinveni ihe wheel every time 
they build a new- car and we don't need to reinveni Mercutio 
every time we want to create dynamic menus. 

Ramon Felciano's Mercutio MDF.F is just one example of 
elegant and powerful reusalile ctxle, Anotlier is the SpriteWorld 
library. SpriteWorld let's you drop a wealth of powerful and 
intuitive graphics code right into your application. In this issue 
Stefan Sinclair explores SpriteWorld libraries and si lows you die 
rundamentals of introducing sjxxUiculur effects into your next 
program. Are you cuitous what other mechanisms there are for 
incorporating libraries into your Macintosh programs or olTcring 
libiaries to other developers? Jeremy Nelson's article provides a 
concise overview of the possibilities. 

The tec:hnologies and opportunilies for plug-in prcxlucLs 
and precompiled libraries on the Macintosh are varied and 
quietly growing. We hope that some of the information you find 
in this issue will help you to explore and profit from those 
opporlunitie.s. Enjoy! 
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Modal Dialog Filter 


Filtering Events in a Modal Dialog 


DLOGFilter shows you how to write a Rlter procedure for 
a modal dialog* As usual* well create and run the projecl here* 
You c:an type it all in* start with Iasi month's column and make 
changes* or just get the project Files from 
<ftp://ftp*maclech*com/src/>* 

Crfatlng niE DLOGFilter Kesookces 
Create a folder named DLOGFilter in your Development 
folder. Next, jump into ResEdtf and ca»ate a new file nametl 
DLOGFilter rsre inside the DLOGFilter folder. 

Create an MBAR resource using the specifications in Figure 
1. Be sure dial tlie MBAR's resource ID is set to 128. 



HBRH ID - 128 from DLOGniterrtrc ^ 
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Figure L Specijicattom for the MBAR resource. 


Next, create three MENU resources using the specifications 
in Figure 2 as a guide. Be sure to include a separator line as the 
second item in all three MENlJs. RememlxT to type in ihe 
appropriate t:omjTiaiid key equivalents (two for the File menu 
and four for the Edit menu). 
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Figure 2* Sped/tcatium for the three MENU resources. 


Next, create a DLOG resource according to the 
specifications in Figure 3- Be sure that the modal dialog window 
icon (8rh from the left) is selected, ihat the 0111 ID is set to 128 
and the "Initially visible" and ""Close lx)x" check boxes are 
unchecked* and that liie Top, Uft* I leight* and Width fields are 
fillet! in as noted, Rememlxr* if your DLOG editor uses Bonom 
anil Right instead of Height and Width* select Show Height & Width 
From the DLOG menu. 



Figure .i Siwcificaiiom for the DLOG resource, 

NexL select Aulo Pdsition from the DLOG juctiu. When the Auto 
Position dialog appeals* u.se the pop-up menus to diftxt Mac OS to 
auloniatk:filly center our dialog on die main screen. 
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Figure 4 Profxir scttingii for our DLOG*s auto-position dialog. 

Next, d()ubltM:lick the i>l;mk dialog lx)x in the niiddlc the 
DLOG editing window to create a new DITL resource widi an id 
of 128. The DITL contains six items. Create an OK button 
(Figure 5) and then a Cancel button iFigure 6). 




Figure 6. Specificalians for the Cancel hutlun. 


Next, create a static text laliel (Figure 7) and its <t>rresp<.>nding 
edit text held (Figure 8). Our dialog filter pnxedure will limit ilie 
niimlxa- of chanuiers enlercxl in this field to 10. 


Edit DITL ttem #3 from OLOGFilter.mc 



Tewti 

Tan iciliir# 


1 Static TchI v] 



□ Fnatired 


Top: |13 { Bottom: 

29 
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124 




Figure Z Specijtcalions for the first static text item. 



Figure 8* Specijicatiom for the first edit text field. 

Now create a second static text label (Figure 9) and iLs 
corresponding edit text field (Figure 10). Our dialog filter 
prcxiedure will only allow the digits 0 tiirough 9 to be typed in 
diis Held. When the OK button is clicked, our main program will 
check 10 be sure ilie number typed was iTCtwcen 1 and 1(X). 



Figure 9. Sjxxificationsfor the second static texi item. 



Figure 10. SiK'cficatiom for the second edit texi field. 

Figure 11 shows the DITL rcj^jurce with all six items in 
j>lace. Notice that the OK button Ls in the lower right comer with 
the Cancel butu^n iitimediaiely to its left, 'nils attention to detail 
is what makes the Mac .so easy u> use. 



figure IL A Imk at the completed DfH resource. 


8 


GirniNt; Stah'it-I) 


MacTkch • JUNH 










































































































































































"The MUST 
€onferei^€e 

serimis a *'. : ; ■ 

pr^grm ' - ■ 

wc^' -; .' ■-- 

With support from Apple® and MacTech® 
Magazine, MacHack is "THE" conference on 
Macintosh programming and development. MacHack 
gives you the opportunity to meet and talk to Apple 
engineers who actually work on the technologies 
you will be using tomorrow. Network with Macintosh 
developers from hundreds of companies and discuss 
programming techniques and issues you are 
concerned about. Unlike conferences where you are 
being talked "at", at MacHack you will be conversing 
with other programmers about real topics that affect 
you on a daily basis. This conference, by definition, 
is technical! 


Registration Fees until April 15/1998: 

Attendee: $425 Speaker: $325 

After April 15thi 

Attendee: $525 Speaker: $420 


MacHack 1998 

rhe 13lh Annual Conference 

for Leading Edge Developers 

June 18-21, 1998 

Dearborn, Michigan 

HeyBiole Speokers 

Chris Espinosa, "Apple Employee #B' 


If you would like to be a speaker please contact 
Expotech at tfie address below. 

For more informotion or to register 
i contact Expotech at: 

1 264 Bedford Rd. 

Grosse Point© Park^ Ml 48230-1 1 16 
Phone: 313-882-1824 
FAX: 313-882-6942 


E-MAI L: expotech^aol * com 
WEB: WWW, mach ack, com 

Mcjantcsli is c trodemofk of Apple Compu+ef. AJf <irii6r5 to iheir r^pedrive hoklBfS. MocHock and the MacHack bgo are jrocfeffiorks of Ewpoleclh, (nc. Not offiliotad wilh jbe MatHcDcfTMl Group. 


You are guaranteed exposure to some of the most 
technically advanced people in the Industry. The 
conference is kept to o small size to encourage 
Interaction. Events are created to foster relationship 
building, sharpen your coding skills, and educate 
you on a variety of topics - no matter what your skill 
level. In short, you'll mingle, network and learn at 
MacHack 1998! 

But that's not all. Developers at MacHack are at the 
bleeding edge of new and emerging technologies. 
Developers for Rhapsody, Java, Pilot, BeOS and 
WinCE wander around, just waiting to share their 
knowledge with all who are willing to ask. 








Now create an ALRT resource using the specifications shown 
in Figure 12. Tliis alert will be used to display varioas messages 
of interest to the user. Make sure that the Dill ID is set to 129. 
Then, change the ALRTs resource ID to 129. (Select Get Resource 
Info from tlie Resource menu.) See Figure 12. 



Figure 12. S[}ecificutiom/hr ihe ALRT resource. 


Next, double-click the ALRT box in the middle of the ALRT 
editing window to create a new DILI resource. The ALRT DILI 
should have a resource id of 129 and will consist of 2 items, I'he 
OK button, used to dismiss the alert, is detailed in Figure 13- 



Figure IX Speci/tcaliom for the alert's OK huUon. 

I'he second DH L item is a static text item (Figure 14). 
Notice that the text provided reads: ^ 0 . The Dialog Manager 
allows you to provide up to four strings (AO, A 2 , and A 3 ) 
which may appear in any item in any DUl in your program, llie 
function ParamTeKt() allows you to substimte values for any of 
these strings. Well use ParamText{) to specify liie message 
displayed by this alert. 


Figure 15 shows the message alert’s DITI, once we^re done 
creating the two DITL items. 

mi PITl ID « 129 from PlOt f 

j*S...1 


Figure 1% We message alert's DILI in final form. 


Creating the DLOCFn.TER Project 

Quit ResEdit, being sure to save your changes. Launch 
CodeWarrior and create a new project based on the Mac 
OS:C/C++:Basic Toolbox 68k stationary. Turn off the Create 
Folder check box. Name the project DLOGFiller.mep and 
place it in your DLOGFiller folder. Remove SillyBalls.c and 
SillyBalls.rsrc from the project: we will not be using these 
files. From the Finder, drag and drop yf>ur DLOGFiiter.rsrc file 
into the project window. You also can remove the ANSI 
Libraries group from the project, because we won't need 
them, either. 

Select New from the File menu to create a new window. 
Save it with the name DLOGFilter.c in your DLOGFilter 
folder. Select Add Window from the Project menu to add 
DLOGFilter.c to the project. Your project window .should look 
something like Figure 16. 
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m 
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Figure 16. DLOGFilter project uHndow. 



□ Enolited 


top: |i I Bottom: [SS | 

Loft: 173 I rnght: [783 | 


Figure 14. Slmcifications for the static text item. 


You may have noticed that our aapplication every month 
has been named “Mac OS Toolbox DEBUG 6BK." This is name 
autoniatically provided by the project stationary. You can 
change this name in the Project Settings Target panel. Open 
your project settings by clicking the settings 1 mutton in the 
Projea window (Figure l6) just to the right of the of the 
target popup, (The popup says "68K Debug Mac OS 
Toolbox/) In the project settings window, select the 68K 
Target panel as shown in Figure 17, Enter “DLOGFilter app” 
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Access, of course, Is everything. And if you're looking to AOL to provide it, you're 
*?!# out of luck. With EarthLink, youl! find that weVe up 99.9% of the time. You 
won't be burdened with the annoying busy signals and disconnects AOL is famous 
for (nor their high prices: weYe still $19.95 a month). And because we have more 
iocai access numbers than any other Internet Service Provider, you can also get on 
the Net more easily. Speaking of easily, that's how you can get in touch with us. Our 
_ phone number Is cleverly listed beiow. Talk to you soon. 


Earth Link Networl' 


(888)QUIT-AOL, ext. 3926 


Stui S19.95 

PER MONTH 


Earthlink 


www.earthlink.net 


©19^8 EarthUfik Necwork, irrc. All righu regerved:Trademarks sre prooeity oMhelr respective owners, 


PC MAGAZINE JSP RATINGS (9/97) 
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in the File Name field, Close Che window, clicking Save when 
you are asked to save and clicking OK if you are warned 
about relinking the project. Now your project wil build the 
appiication using this name* 



Figure 1 Z DlOGFilier project window. 


Waoong Through the SoiiRcii Code 

DLOGFilter starts off #lnclucling necessary header file-s, then 
it begins a series of #defines. You 11 see tliese again as they are 
used iluoughout the code. 

I know this is obvious, but here's a word or two about the 
naming convention 1 use in my code. Start all constants with a 
lower-case k, with two exceptions. Menu and dialog items start 
with a lowercase i and menu resource id's start witli a lower 
case m. Notice that liie remainder of the constant name is 
spelleci according la Pascal rules, as opposed to C rules. Pascal 
starts each word with an upper-case letter, while C traditionally 
uses all upper-case letters, separating each word l:>y an 
underscore (_)* I think Lite Pascal method is much easier to 
read. As it luippens, most of Apple's C code uses the Pascal 
conventions as well. 

ffinclude <I)ialogB.b> 

^include (Mentis.h> 

J include <Qujckdraw.h> 
inclLide (Sound.h> 

#deflne kDi^ilogRyslD 
^Idefine kMBARld 
^define kMessageAlertlD 

#define kSleep 
ifdcfine kMoveToFront 
ifdefiiie kMULLFil terProC 

#define kOn 1 

kOff 0 

#define kEditltemExists 
ijfdefi Tie kEvfintNotHandledYet false 


jjdeflne kEvciuHandl ed tru^ 

^define kMaxPieldLength ID 

|fdefin& kEnterKey 3 

#define kEi^ckSpaceKey B 

^define kTahKey 9 

^define kRetitroKcy il 

^define kEscapeKey 27 

^define kLeftArrov 23 

tfdefine kRightArrow 29 


i2e 

128 

129 

60L 

(WindowFtr]-IL 
NULL 


true 


ifdefine kUpArrow 30 

//■define kDownArrow 31 

^define kPeriodKey 46 

//define kUeleteXey 127 

i/dt* line iTenCliarMaxText 4 

tfdefitie iKumberText 6 

//define mApple 128 

//define iAbout 1 

Ddefine mPile 129 

I/define iDialog 1 

//define iQuit 3 


As usual, we've declared the global gDone as a Boolean 
CO tell us when to drop out of the main event loop. As always, 
wc start global variables with the letter g. There arc lots of 
other naming conventions for variables. For example, some 
folks start their variables with a letter indicating the type of 
the variable* This can come in handy if you are writing code 
that gets shared among a group of people* 

Roolean gEone: 


Here's the function prototypes for every single routine in the 
prognim. Get in the habit of providing function prototypes for all 
your routines. Since C++ requires function prototypes, tills is a 
good habit to get into* 

Fufu-Iiuns 7 

void ToolboHlnit[ void 

void MenuBarInit[ void ); 

void EventLoop( void ): 

void DoEvent/ EventRecord 'eventFtr ): 

void HandlcMouEeDownt EventRecord 'eventPtr 3 e 

void itandlcHi:imCboice( long tuenuChoice ) i 

void HaudleAppleCtioice[ short item ): 

void HandleFileChoicet short item ); 

void DoDialogC void ); 


Here’s an unusual prototyfie. Look at tlie return type for the 
function DLOGFilter(). 

pascal Boolean DLCK^Filter/ DialogPtr dialog* EventRecord 
‘eveutPtr* cbort 'itemHitPtr ); 

The pascal keyword tells the compiler that this routine 
should be called using Pascal, as opposed to C, calling 
conventions. Here’s why tliis is imp<3rtant. When your code 
calls a regular C function, the compiler has no trouble using the 
C function-calling conventions. When you call a Toolbox 
function, the rules change a bit. Since the Toolbox was 
originally written in Pascal, all calls to it are made using the 
Pascal calling conventions. When you call a Toolbox function 
from your code, the compiler is smart enough to use the Pascal 
convention to pass parameters and rerum the return value to 
your code. The compiler knows to do this because llie Toolbox 
function prototypes use the pascal keyword. 

Where things get tricky Ls when you write a function in C 
that you’d like to be called by a Ibolbox fiinction. For example, 
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in Lliis pro^'ram, wcVe rmating a function that will be called, 
periodically by ModalDialog(). Which conventioas dtj wc use, C 
or Pascal? As it turns out, we yield to the Toolbox and declare 
our function using the pascal keyword, Ifs not important to 
understand tlie difference lietween C and Pascal calling 
conventions just as long as you remember this rule: If your 
n)uline is designed to be called by the Toolbox, be sure to 
declare it using tlte pascal keyword. 

Here's the rest of the function prototypes. 

Boolean ScrapIsOnlyOigits[ void ): 

Boolean CallFiiterProc( DialogPtr dialog. 

EvantRe.oord '*ev«nrPtr, short * ItemHJ tPir ); 
short CurKdltFieldC DiatogPU dialog ): 

short SelccLlonLengLhC DialogPtr dialog )i 

void Message{ Stt25S messageStr ); 


main() initializes the I'oolbox and menu bar, then enters the 
main event l<K)p. 

void void } 

f 

Tooli>oKlnlt 0 ; 

MeouBarlnitO: 

EventLoopO i 

I 


Notice the new .spelling of Toolboxlnit(), (I used to spell it 
ToolBoxInitO — Aack!) 

r**^* .. Toolboxlitit 7 

void Tootboxlnilt void i 
[ 

initCtafC &qd.thePart ): 

InitFontsO: 

InitWindowsO; 

InitMenus ()i 
TEInitfS; 

ItiltDialogsl Nm.I )i 
TnltCursorO i 


Not too jnuch new here. 'Ihis time I added a constant for tlie 
MBAR resource id. 

/•**«*«*«*«^**«*.MfjiuBiitMl 7 

void MenuBarInit { void ) 
i 

Bandle meouBai:; 

ManuUandle menu: 

menuBar ^ GetHowKBart kHBAKid ); 

SotMcnuBar( monuiar ); 

menu ” CetHenuHandieC wApple ): 

AppetidReaMenu( mem. *DRVH’ h 

DrawHenuBat (); 

1 
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Same old, same old.„ 

.FventhMjp V 

void EventLoop( void ) 

I 

EventRecord event; 

gDone = false; 

while ( gDone — false ) 

( 

if { WaltNcxLEvent( everyEvent, &event, kSleep, NULL ) ) 
DoEvetit( &event ); 

I 

) 

Because our program supports only menus and a single 
dialog, we'll handle only a few events. The dialog window 
events are handled by the Dialog Manager, 

DoEmit 7 

void DoKventt EventRecord “cvcntPtr ) 

{ 

chat theChat; 

switch t eventPtr">vhat ) 

I 

case mousoDown: 

liandleMouscDovnt eventPtr ); 
break; 

case keyDown; 
case autoKey: 

tbeChar ™ €ve[itPtr->inessage 4 charCodeMask; 
if ( f event Ptr->iodi flora & cindKey) D ) 
HandlcKem]Cholce{ MenuKeyC theChar ) ): 
break; 

) 

1 

Last month's version of HandleMouseDown() included code 
for dragging a window around ttie screen. Because we don't 
have any windows, I took tlie liberty of deleting the unnecessary 
lines. Sorry about the extra typing. 

]iani!lt-Mouscl>uwii V 

void HandlcHooseDowTit EventRecord *eventPtr ) 

I 

WindowPt r wiiidow; 
short thePart; 

long menuChoice; 

thePart " FindWindovt eventPtr->whore, ^window ): 

switch ( thaPact ) 

[ 

case inHonuHar: 

monuCholce = KenuSclectt evchtPtr->whete Ji 

HandleHenuCholce[ meimCbolco ); 

break; 

case inSysWindow i 

SygtenClick( eventPtt, window ); 
break; 

I 

1 

Pretty standard menu handling code. HandleMenuChoiceO 
dispatches the menu selection... 

^ r r n r - I r - 7 - HandfcMcnuOioice 7 

void UaodleMenuCbolcet long mennChoice ) 

( 

short menu: 
short item: 


ir t JnenuChoice != 0 ) 

( 

neno = HiUord( ■anuCholce ): 
item Loyordt uenuCholcc ); 

switch ( menu 1 

I 

case niApple: 

HaftdleAppleChoiceC item ); 
break; 
case mFile; 

ikndleFileChoice{ item ); 
break; 

J 

HiliteHenut 0 ); 

I 

] 


HandleAppleChoiceO handies selections fmm the Apple 
menu. Feel free to add an alxjut alert of your own design. 

Mvittrtttntnrttri«tM ii HandlcApplcChoiCC 7 

void KandleAppleChoicet short ilen ) 

I 

MenuHandle app1eMenu; 

Str2S5 accMame; 

.short accNumber; 

switch ( ItOB ) 

1 

case iAbout; 

SysBeept 2G }; 
break; 
default; 

appleMenii = GetKenuHandle( mAppie ); 

GcLMeniiltetoText { appleKenu, item, accName ) ; 
accNumber = OpenfleskAcct accName ); 
break; 

I 

I 

HandleFileChoice{) handles llie File menu .selections. The first 
item in ilie RIe menu Is the Dialog item, which displays our 
filtered dialog. 'Ilie dialog is handled by the routine DoDialog{). 

w.* + 1 « 4* HandtcRlcChoicc 7 

void FfandleFIleChoicet short Iteai ) 

i 

switch ( item ) 
i 

case iDialog: 

DoDialogC); 
break: 
case iQuit: 
gDone = true: 
break: 

I 

I 

DoDialogO starts by loading the DLOG resource using 
GetNewDialogO. 

. .*—DoDidcig 7 

void DoDfalogC void ] 


DiaiogPtr 

dialog: 

Boolean 

dialogDorie “ fal 

short 

itenHit, iType: 

Handle 

iHandle: 

Rect 

iRect; 

Str255 

numberStr; 

long 

number; 
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The best tool for text. 

BBEdit. The premier text & 
HTML Editor for the Mac OS* 


From those who know... 




“Tve been using BBEdit for about a month and now 
find it invaluable. It seems to offer jus! the tools I 
need not only for HTML coding (which is what 
I bought it for), but also for writing and 
research, which came a.s a surprise. 

As a devotee of light and flexible vs. 
bloated and unwieldy, IVe taken to 
using BBEdit for tl>e daily grind 
of niy writing chores. When I 
get bored, I just ttim to 
and toy witli some complex 
search and replace expression! 

Thanks for your solid work.” 

David Ef/dy Spicer 
Assistant Director, 

Case Program 
John E Kennedy 
ScJioot of Government 
Harvard University 


use BBEdit every day and 
Tm continually blown away by 
the inteiligenl interface, the 
power user features like ‘grep*, 
search and vc^cc across mult^ 
files, the syntax coloring, dre Fl’P 
open & save, the ainfiguiabtlily, 
Internet Con%, evoything. Every 
time I think of sometliing Fd like 
to see added to the program, I 
discover that it s already there. 
You guys really thought of 
everythitig! When I use other 
programs, t find myself 
wishing for the features 
that BBEdit has.** 

Chris Vurosy 
US Web/Drawi Media 


<http://wcb.barebones.com/> 


MocUur' 


MacL^er 


D- Bare Bones Software, Inc. 

P.O.Box 1048, Bedloia, MAOITSO • main7Rl.fi87.<17aO • fax 781.687.0711 


BBI^t is a trademark ol Bare Bones SoftMere, (nr- "It Doesn't Suck" is a legistenxl Irademaik o( Bare Bones Softuete, be. ® 199S Bare Bones Sobwae. be. All rights resetved. 




























Strictly Sfx^aking, you should check the value returned by 
GetNewDialogO- ITiis will keep you from an emlrarassing crash if 
the DLOG resource couldn't be loaded for some reason (like 
there's no more memory left, or the darn thing just wasn't there). 

dialog “ fetHewDialogt IcDialogKesID,. NULL, kMoveTofront ); 

As usual, we make tlie dialog visible, make it the current 
port, then configure it with three Toolbox rt)uiines. 

ShowWindovf dialog ); 

SctPortC dialog )■ 

SetDialogDafaultTteni( dialog, ok ): 

SetDialogCaiicolItoiiv{ dialog, oanool ); 

SetDialogTrack£(Citrsoi:( dialog, kEditltemExists ); 

Check out the tech note that describes lliese routines. (TB 
37 in the new numl>crs, Tech Note 304 in the really old 
numlxrrs.) You can find them on the developer CDs and, HI bet, 
on-line at <http://devworld.apple.com/>. 

With the dialog window visible, we can enter the main dialog 
l<K)p. Wc’ll drop out of the loop once dialogDone is set to tme. 

while ( I dislogDone ) 

I 

The loop consists of a call to ModaiDialogO and a switch to 
interpret the result returned in itemHit- The first parameter is a 
pointer to a filter function. Our filter function is named 
DLOGFiller. Note the lack of parenthese.5 in the function name. If 
we included the parens, the funtiion would l)c called in place 
and the return value would lie passed as the first parameter to 
ModalDialogO. We'll get to DLOGFilterO in a minute. 

MtjdalQialogf DLOGFlltfir. WtesiHit ): 

switch ( iteratliL ) 

t 

If the OK button wa.s clicked, we'll call GetDialogltem() and 
GetDIalogItemTextO lo retrieve the text in the Number (1-100): text^ 
edit field- 

case €ik: 

GetDialogTtem(dialog, iNunberTeitt. kltype, iiliafidle* 
h 

GetDialoglteiiText { IHandlft, iiiwibetStr): 

If the field is empty, we’ll print a message asking the user to 
enter a numlier in the field. 

tf ( nmnberStr f 0 | ^ 0 ) 

I 

Message {"\pYou must enter a number in the number fieldl’'): 

I 

Otherwise, we'll c:nnven the text in the field into a number, 
then lest to sec if the numl>er is between 1 and 100, If so, we can 
drop out of the loop. 

filse 

I 

SiringToNumf numherStr, inuaber ); 

if ( (number >= 1) && (nuraber <- 100) ) 
dialogikjne = true; 


If the number is not in the required range, we'll print the 
appropriate message, then highlight all the text in the field. 

else 

( 

Message("\pPiease enter a number between 1 and ICO..-'* ); 
SelectDialogltemTextC dialog, iHumberText* 0, 12767 ): 

1 

J 

break; 

How c:an we sure that the text in the field is a number? 
As you’ll see, that's part of the job of the filter prtx;eduie. 
DLOGFilterO makes sure that only numeric charaaers are entered 
in the number field. 

If the Cancel button was pressed, we'll drop out of the 
dialog loop, 

case cancel; 

dialogDone “ true; 
break: 

I 

1 

Once out of the loop, we'll free up the memory occupied by 
the dialog, then print an appropriate message. 

DiaposeDiaiogt dialog ): 

If C iteraHit — ok ) 

Message( "\pYour timnber was vaiidin” ): 
else 

Hessaget "\pDlslog cancelled,,," ); 

[ 

DLOGFilterO railed every lime ModaiDialog() encounters 
an event. Pointeis to the dialog and event are passed as the first 
two parameters. *11ie third parameter alli>ws DLOGFilterO to set 
the value of itemHit. 

If the event is handled by DLOGFilterO (and we want 
ModalDialogO to ignore it) we'll return a value of true, being 
sure to set the value tif itemHit first (via itemHitPtr), If we 
didn’l handle the event, well return false, asking 
ModalDialogO process the event. 

.DLCXdilUfi 7 

ptiscnl Ronlonn DLOGFilter( DialogPtr dialog, RvijntRecord 
'evcritPir, short ) 


char 

c: 

short 

iType: 

Handle 

iHandle: 

Rect 

IRect; 

Str255 

textStc; 

long 

scrapLength, ScrapOffset; 

short 

sgIccL engthI 


In this prognun, we're only interested in keyDown and autoKey 
events. Feel free to add whatever events you like to the switch- 

switch ( thventPtr->whflt ) 

f 

case keyDovn: 
case autoKey; 
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All tlie signs point to 
Developer Depot... 



And, you know the address! 


http://www.devdepot.com 


Developer Depot 


PO Box 5200 

Westlake Village, CA 91359-5200 
Toll free US/Caoada: 800/MACDEV-l 


Voice: 805/494-9797 
Fax: 805/494-9798 
E-mail: orders@devdepot.com 
Web: http://www.devdepot.com 








If the key pi^ed was one of those in the if clause, we'll call 
tile default filter prcx:edure (the one ModalDialog() t:alls if we don’t 
provide one), returning the result returned by the default rillcrf>r 0 c. 

c = ( event Ft r - > rae s s age & cha r CodeMa sk) ; 


if ( {c kReturnKey) 
(c = kTabKey) || (c 
{c = kEscapeKey) |' 
(c = kRightArrow) 

{c ^ kDownArrow) | 


II (c "" kEnierKey) 
= kBackSpaceKey) 

(c = kLeftArrow) 

I Cc = kUpArrqw) | 
(c kDeieteKey) 


return {CallPllterPtoe( dlalng, eventPtr, iteniHitPtt 
1 


)): 


Otherwise, we’ll check to see if the edit cursor is iaside the 
Ten chars max field. 

else if ( CurEdltFleld{ dialog ) = ITenCharHaxText ) 
f 


Tf SO, well retrieve the text from that field. 


If the field is full and no charaaers are selected (and thus 
replaced by the typed chameter), we’ll beep and return false. 

±f (f text St r [ 0 ] = kMaxTleldLength) 

&& (selecLength ^ 0)) 
f 

SysBeep t 20 ): 

return( kEventHandled ): 

1 

Otherwise, we’ll let the default filterproc handle the 
event normally. 

else 

return( CaliFilterProc[ dialog, eventPtr, itemHltPtr ) ); 

1 


So much for the Ten chars max field. Now we’il liandle an 
event that occurs when the current field is the Number (1-100) field. 

else !f { CurEdltFleld{ dialog ) "" iNumberText ) 
f 


CetDialogltejii(dialog, iTenCbarMaxText♦ firiType, 
fiiiHandle, &iRect); 

GetDia1 0 gltemText C ifiand1e * t ext St r); 


Next, we'll find out how many cliaracters in tiiat field arc 
currently selected. 

selecLength “ Selectioiiength( dialog ): 


Tills next line Is superfluous. Feel free to delete it. 

G^tDlalogIteiii{ dialog, IKumbetTaxt, SlType., 

&lRafidle, SrlRect }: 

Once again, well retrieve the length of the current selection. 

eelecLengtli = SelectionLengtlit dialog ); 


If the current event represents tlie key sequence V, we’ll 
check to make sure the text in the clipboard woiVt push us over 
our ten character limit. 

if ( { (eventPtr->nK>difiers k cmdKoy) 0) 

£t& (c -- 'v') ) 

[ 


Next, we'll check to see if a V was typed. By the way, the 
Dialog Manager will convert a selection of Paste from the Edit 
menu to a V for us. Try it. This code should .still work. 

if ( ( (eventPtr >tnodlfiers & cindKey} )" 0) && 

Cc = W) ) 


First, we’ll call GetScrapO to find out how many characters 
are in the clipboard. To prognimmers, the clipboard is known as 
the scTap, thus the name GetScrap(). Since the scrap can contain 
many types of data, we must specify that we are interested in 
TEXT data (as opposed to PICT data, for example). 

scrapLength = GetScrap( NULL, ^TEXT'. SscrapOffset ): 

Tf the text thafs in the currenf field, plus the length of the 
scrap, minus tlie selecTion length (remember, the selection will 
i:>e replaced by whatever is pasted) exceeds the 10 char limit, 
we'll beep and remrn true, 

if CtGxtStx[0j+ scrapLength ■ selecLength 
> kMaxPieidlength) 

I 

SysBeep( 20 ): 

"iteinFlitPtr ■= ^TenCbarffaxText; 

returnC kEvetnHandled ): 

I 


Otherwise, we’li let the default filterproc handle the paste. 

else 

return(CallFilterProcC dialog, eventPtr, ItemHitPtr) 

1 


If V was typed, we'U check to be sure the scrap contains 
only digits. If so, we’U let the default filterproc handle the paste. 

if f ScrapIsOniyDigitsO ) 

( 

return{ CallFilterProc( dialog. eventPtr, 
iteniHitPtr ) ) ; 


Otherwise, we'D beep and return. 

elae 

I 

SysBeept 20 ); 

•itemHitPtt = iMumberText; 
returnC kEventHandled 


If the character typed was not a digit, and the command key 
was not held down, well l)Ccp and return. 

else if ( C(c < “OT | | (c > ^9’)) £.& 

( CeventPtr->inodifiers k cmdKey) ^ 0) } 

I 

SysBeep( 20 }: 

*itemHitPtr ’= iNumberText: 
return( kEventHandled ); 


18 


Getting Started 


MacTech • June 1998 









•' rant, 
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^Crgiate REAL applications with one finger... 

’''-V 



Use the others for something else. 


$ REALbasic 

Visit www.realbasic.coni for a FREE DEMO 

REALbasic is a trademark Off REAL Software, Inc 
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Object-Oriented BASIC 
100% Visual Interface Builder 
Compile Native 680x0, PowerPC, and JAVA 
Supports XCMDs, AppieScript and Native Plug-ins 


If the character typed was a di^it, or if a command-key 
sequence of any type was cnlcrcd, we'll let the default 
filtcrproe handle it. 

elfSfi 

I 

r£?lLjrn( Call FlIterFrort dialog, eventPtr* it^mKltPtC ) ): 

1 

1 

breakr 
I 

If anything else slips through, well let the default 
filierprcx' handle it. 

returnt CallEiitcrPr0c( dialog* ovcniPtr, itetnHitPtr ) 

» 

You may have nr>ticed ihai we started ihc filter off by 
checking for chaniclcrs like return, enter, tab, delete, and the 
arrow keys. These are context-free keys. In other wf>rds, their 
importance is not related to the trurrent field. We try to get 
those out of the way Orst, before we start checking for input 
related to a specific field. 

ScrapIsOnlyDigrtsO checks the conienis of the scrap to make 
sure each ctiaracLer Is a digit, IxHweeii 'O' and 

flooleaii ScraplaOrilyDigiU{ void ) 

I 

Randle textHandle: 

long scrapLength, scrapOffset; 

Boolean onlyDigits “ true: 

unsigned short i: 


First, we'll alloc'ate a new, minimum-sized handle. The Mac’s 
Memory Manager will alkx^ate the minimum size l)lock of memory, 
then return a pointer to a [X>inter to the block. We'll get into 
handles in a later column. Fcjr the moment, just hear with me. 

taxtHandle = NewKandle( 0 ); 

Wc pass that handle to GetScrapO, asking it to retrieve data 
of type TEXT from the scrap^ resizing the handled block lo a size 
appropriate to hold tlie retrieved text. 

scrapLength ’* GclScrapf TextHandln* ‘TEXT’. fitScrapOffset ): 

If the scrap was empty, or if text couldn't be retireved 
(scrapLength was negative), we'll return false. 

\f ( HCrapLength <= 0 ) 

returnt faljje ): 

Since we are about to singly dereference the handle, we liave 
to kx:k it. Once again, wc'II talk more alx)ut this in a future column. 

HLock{ textHandle ): 

Next, we’li walk through die text, checking for non-digits. 

for ( i=0: i<scrapLengLh: 1++ } 

f 

if (((*textHandie)[i] < '0') || ((*texiJlandlc)[i] > '9')) 
onlyDigits ^ false: 


Interested in advertising in MacTech Magazine? Contact our ad sales department at 

<mailto:adsales@mactech.com> 
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Next, unlock the handle, release the memory, and return 
the result. 

HUnlock{ textHandle ): 

DisposeHandleC textHandle ): 

return( enlyDigIts ); 

I 


CallFilterProcO is our next step. 

aUMllcrProc 7 

boolean CaliFiitecProct DiaiogPtr dialog, EventRecord 
'eventPtr, short *itemHitPtr ) 

[ 

ModalFilterProcPtr theModalFroc: 

OSErr myErr; 

GetStdFilterProcO retrieves the default filterproc. The 
default filterproc takes care of things like drawing Lfic tjutline 
around the default button, checking for the cancel key- 
cquivalcnLs, and changing the cursor to the i-beam when the 
cursor is over a text-edit field. 

inyErr = GatStdFilterProcC&theKodalFrEVc:): 

If (iryKrr = noKrr) 

reLiirnt LhoHodalProc ( dialog. eventPtr, iteraHitPtr ) ): 
tilse 

return( kEventNotHandledYet ); 


CurEditFieldO peeks into the dialog's data slmclurc and 
neuims the adjusted value liidden in the editField field, 

n .«*M.*«***«*^***«*. CurMtFicId V 


short CurEditField{ DialogPtr dialog ) 
f 

returnf ((BlalogPeek)dtalog)-)cdlLFiold + 1 ): 

1 


Selection Length 0 stares by retrieving the current TE Handle From 
the specified dialog. The TEHandle is a handle to the struct 
describing the cunent text-edit field. Die selEnd and sefStart fields 
de,scri[>c the position of the end and beginning of the text selection. 

1 ««** sdrctionlxmgth 7 

short Sel«ctlonLength( DialogPtr dialog ) 

I 

TEHandle teH; 

teH ^ ((DialogPeek)dialog.]->tcxlH: 

returnC {* *teH).nelKnd {**teH),selStart ): 

] 

MessageO puts up an alert containing the si:)ecilied text string. 

Message */ 

void Mesaagef Str255 raessageStr ) 

I 

fihort iinij.'Sed; 

P^i;ra(riTGxt( mensageStr, "\p^. ”\p" ) ; 

unused = HoteAlert( ItMessageAlertlB. kNULLEilterProc ): 


Running DLOGFitniK 

Save your source code and then choose Run from the 
Project menu. When DLOGFiIter starts ninning^ a menu bar with 
three menus (Apple, File, and Edit) will appear. If you .select 
About DLOGFilter from the Apple menu, the program will beep 
at you. Since you already know how to implement an about 
alert from past columns, I didn't want to take up space in Lhi,s 
column with a real about box. 

Next, click your mouse In the File menu. The fust item, 
Dialog, has a command key equivalent of D. Type D or select 
Dialog from the File menu. Eidier way^ a dialog box will appear, 
just like tlie one in Figure 18. Notice that the text edit cursor is 
in the first of the two text edit fields. 


Ten chars maH* f 
Nymber (1-100): 


[ Caiicel ] 



Fi^fure 18. The Df OGFilter diakyg. 


To .start things off, press the Cancel button. Tlie alert shown 
in Figure 19 will appear. Click the OK burton and type D to 
bring up the dialog again and this time, type -. (command- 
period). Once again, the “Dialog cancelled” alert apj^eais. Once 
more, click the OK button and type D to bring up the dialog and 
this time hit the escape key. As before, the ‘^Dialog cancelled” 
alert a]:)pears. Click the OK button to dismiss the alert. 



figure /9 Wis alert appears when you Cancel the 
DLOCFilter dialog. 

Type- D to bring up the dialog again. This time, type the 
characters 1234567890 in lIjc first field. Now type another 
character, [‘he dialog will beep at you and your character will not 
appear. A.s you can see, this field limits you to 10 chanicters. Try 
copying .some text to the diplx)ard, then pasting it to the field, 
You will succeed only if the numlx^r of characters in the 
cliplx)ard plus the number of characters that are not selected in 
the field doe.s not exceed 10, 

Without typing anything in the second field, click the OK 
button. The alert shown in Figure 20 appears, telling you to 
cnlcT a number in the second field. 
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The Programmable Power Strip 


Take control of your Mac system! 


Cmpyriyin SopliJSlicfitcttCircuiiJi, \nc. PaWfirKey \t a trndairtark dI Saiihifiticated Circuits, Inc. 

MflciFtrosh stnd Mac afo rcgiscsfed tr^fd&morks o! Apiplo CoinpuiBr. Inc, 


800-769-3773 www^sophisticated.com 


SOPHISTICATED CIRCUITS 


up your entire system with a 
keystroke, or when the phone rings, or 
every morning, or in the middle of the 
night each Thursday. Switch outlets, 
pen documents or run Apple- 
Scripts. Let your computer do those 
boring backups while you sleep. 

PowerKey Pro s scheduling software 
lets you easily create powerful 
events to control your system. 
It's fully customizable to work 
the way you do. Put this power 
to work for you today! 


Model 200 

► Two groups of switched outlets 
' Telephone ring detection 

» Add Server Restart Option to 
automaticaHy restart crashed 


Model 600 

All the features of Model 

200, plus... 

• All six outlets are 
individually switched 

• Front panel switches and 
indicator lights 

• Answer the phone and run 
events with custom dialing 
tones 

• Server Resiarl Option included 
free (for a limited lime) 
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You mus! enter a aumtier In the 
number fleldl 


i 1 


Figure 20. Another message alert. 



Figure 22. A final message alert. 


Click the mouse in the sc'cond field and type a non-numeric 
character (like the letter x). Your Mac will beep at you, telling 
you iliaL you can only type numeric characters in tliis field. Now 
tyj>c file number 355 in the second field and click OK. Tlie 
message alert shown in Figure 21 appears, telling you to enter 
a number iKiween i and 100. 


E Please enter e number | 

betiueen I and tOO,.. 

Figure 21, Yet another message alert. 

Click OK to get back to the dialog and type a numl>er 
between 1 and 100 in the seaind field and click OK, The 
message alert in Figure 22 tells you that your input wa-s valid. 


Tai Nhxt Moniii... 

At the heart of this program was a filter prcK:edurc that the 
Dialog Manager called repeatedly to preproccss all the events 
asst)ciai.ed with the main dialog box. The filter procedure was 
responsible for limiting the cliaracters that appeared in the two 
text edit fields. As an exercise, try changing the program so the 
OK biiiu>n is tliimned until a valid numlier is entered. You'll need 
to check and adjust the OK button inside the filterprot:. 


Want to suggest an article for the 
magazine? Send your su^estion to 
<mailto:editorial@mactech.com> 
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TOOLS OF 
THE TRADE 


by Steve Sheets 


BBEdit Plug-In Programming 


Creating Extensions for 
Bare BPwes Software’s 
BBEdit Text Editor 


The Rk;ht Tool for riiii Right Job 

A,s a well known starship engineer 
would say. ‘"always use the nglit tcxil tor 
the right job". It’s true for dilithium 
dianilxTs and it is tme for Macintosh 
develupnient. When working with 
resources, ResEdit anti Kc‘sorcerer arc the 
best tools available. HyperCard and 
Macromedia Director have been tfie 
favorites of two generations of multimedia 
authors. Eurt of wliai makes these tools so 
[lowerftil is the potential to custoinixc them 
through ResEdit templates, Resorcerer 
“apprentice" plug-ins. HyperCard XCMDs, 
and Director Xtras. This plug-in 
extendibility let's you cu.stomi2:e and fcxrus 
their features to turn a great tool into the 
perfect tool for your job. The text editor 
blJEdit is one of the best at whai it does 
and its basic functions can also be 
extended with third party BBEdit 
extensions. This article will descrilx; how to 
create your own BBEdit extensions so you 
can apply the power of BBEdit to the 
unique i^hallenges in your projects. 

TllL RiOHT T(K>1. 

FOR THE RiGIH' EDITING 
Bare Bones Software's BBEdit is a 
powerful text editor. A text editor is not a 


word processor (where the output is intended to be a printed 
page). BBEdit is just for text files — the source file fonnat for 
almost all compilers and mterpreters. Many developers prefer 
using BBEdit or another third party editor instead of the text 
tcK>i built into standard development environments (like 
Api^lc*s MPW, Metrowerk's CodeWanit>r, Symantec G++ or 
Symantec’s Visual Cafe). Tliis preference has become wide 
spread enough that most IDEs now have explicit support for 
external editors. BBEdit is also a pripular t(x>l for web page 
design (text being the source format of all HTML web pages) 
or any other job tfial rctpiires text manipukition. 

While the built in features of BREdir are impressive to begin 
with. BBEdit has an additional method U> add functions — the 
extensions Eacli plugdn is a code resource, of type 'RB>rr, 
that is loaded in, executed and unloaded when the user seIccLs 
die corresponding item in ilte exiension menu. Bare Bones 
Software uses the API themselves and BBEdit ships with a 
couple do/.en [jlug-ins. 

When executed, the ]>lug-ins can do any number of text 
manipulation tasks. Ilte plug-in can even have limited user 
inieradioit, as in the case of modal dialogs or Sutndard File 
dialogs. However, the [>lug-in does not have access to any global 
memory nor to any settings of the BBEdit applicarion itself. 

A plug-in also has access to a large list of callback 
services. These services are ftinctions that Bare Bones 
Software pnivides to do common tasks such as accessing or 
changing the currently selected text, creating or opening new 
windows, and creating message, progress or error windows. 
Additional functions make it easy to handle undo, 
AppleEvcnts and grep type commands. 

Beyond these u.ser interface and single use limitaikjns, 
BBEdit plug-ins can do almost anything with or to a text file. A 
plug-in can be a simple tool to autt>inaLe some changes in the 
selected text, or it can lie a sophisticated compiler (C++, Java, or 
Resource) iliat processes a text file into another fornoat. Tlie only 
iimii is the developers imagination. 


Steve Sheets has been liiippily prpgnimming die Madntush sintx? 1983, whidi makes him older than lie wLsfjes, hut not as young as 
he acts. A native Californian, Ms wanderings have led liini to northern Viiginia. For those interested. Ids non-computcT interests involve 
his family (wife and two daughters), tiie Sociciy for Creative Anachioni.sm (medieval teenaoment) and the maitml arts (Fennng, Tai 
Chi). Steve is cunentfy an rntlqxmdttit developer, taking on any and all piujeets and can be reached at <MageSie\'e#aul.ajm>. 
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Tliis article will explain the format of a BBHclit plug-in 
(resource and file). The extension interface will Ixj described, as 
will the plug-in control flags resource. Several, but not all, of the 
callback services will be descrilxrd. Two examples of BBRdit plug- 
ms are included for you to learn from. Bare Bones Software 
provides a complete SDK with all commercial vereions of their 
.sTiffware and you can download liiis kit from tlie BareBones wel) 
site at <http:/AiVWW.bafebones.com/>. The SDK includes a manual 
explaining all the calls, as well as the required inierface files. 

Extfn.sion Rhsouhce and Fujf 

A BBRdit plug-in is an old fashion code resource, like an 
desk acces.sory, FKEY or menu prex:. The code resource can he 
a traditional 68K resource or an accelerated PowerPC cxxle 
resource. 'Hie ctxle resource can even be a faf cxxle resource 
that contains lK>lh. For most developers, a 68K version of their 
plug-in is l>est since it can nm on Ixah platforms. You only need 
to create a PowerPC versit>n to take advantage of the increased 
speed of native ctxlc. 

Any number of plugdns can exist inside a single BBEdit 
plug-in file. 'Ibis file must reside inside the ^'BBEdit Pkig-Ins" 
folder, which is ItKated beside the BBEdit Application. The file 
t'an also reside in a sub folder in die BBEdit Plug-ins folder, 
which would cause the plug-in to appear inside a submenu in 
the application. Tliis is a gcxxj way to group plug-ins. lliis 
nesting only gem down one level. Tlie BBEdit file must of file 
type 'BBXT. It's creator type cun be anything (allowing custom 
icon bundles) but if the Lyfx: is then the file will have the 

generic BBEdit [)lug-in icon. BBKdit will work coirealy tf aliases 
tt> die actual plug-in file are placed in die pfug-ins fokler. 

A BBEdit plug-in is a code resource of type 'BBXT. Hie ID 
can be any numlnjr, while the name should dcscrilie the plug-in. 
RHFdii will use thi.s name when placing the plug-in in the 
extension menu. BBEdit opens the plug-in file a.s a re5yOurce file 
when the call is executing, so the plug-in can access other 
resiiurccs in the file. 

Along with the code resource, the plug-in file can contain an 
optional ‘'plug-in control flags” resource. This resource is of type 
‘BRXF’ and has the same ID as the plug-in it is associated with. 
The resource contains 4 bytes of data, each bit signifying a 
specific flag. The easiest w'ay to create and modify this resource 
is with the “BBXF" resource template provided by Bare Bones 
Software in their SDK. A Rez resource header would have i>ecn 
nice, but is not currently available. 'Ihe flags resource provides 
the BBEdit application witli information alxiut what the plug-in 
dim, and when it can be invoked. These flags will be explained 
in more detail below. Tecluiically, this flag resource is not 
required for an old style plug-in, but is necessary if you wish to 
signify diat your plug-in is a new style one. 

Calling Coiwentions 

The original or old calling convention had a pasail style 
funaion as the main entry point The funaion was pas,sed a 
callback pointer, and the window pointer <jf the top most 
window. BBEdit version 3 5 and later supfX)rt a newer calling 


Version Control for the masses! 


CWProjector 
and eweVS 

CWProjector and CWCVS are CodeWarrior™ 
plugins that provide effortless access to the 
popular and widely available MPW™ Projector 
and GNU CVS version control systems. 

For $20 you can use version control from 
within CodeWarrior^. Download now from: 

bttp:/'w w w.electricf ish.com/hawkf tsh/CWProjector/ 
htt p://w w w.electricf ish. com /ha wkf ish/CWCVS/ 



Electric Fish Inc. 


convention. While the older conventit>n remains, it has all but 
been replaced by the new format. The new format provides 
more information, as well as supporting Apple Evenis, The new' 
style does require tJie BBEdit application to run under System 
7.0, bui this is no longer very limiting. The new style calling 
convention has a main entry jx)int defined as: 

pascal OSErr maia(ExternalCallbackBlock ‘callbacks, 
WindowPiF w, long flags, AppleHvenl ‘event, AppleEvent *reply); 

Tlic routine returas an OSErr result indicating the errors, if 
any. If the plug-in run.s successfully, this should lx? set to noErr 
(0). The ciilllrack parameter points m a structure used by the 
BBEdit application and the BBEdit callback routine.s. While the 
f>lug-in has access to the structure directly, the stmciure may 
change in future revisions of the application. Therefore, it is 
strongly recommend you only access the callback using die 
callback services routines or macros. 

The w parameter is the WindowPtr of die top most window, 
while the flags parameter provides information about the 
applications airrenl .state. T!ic flag pammeter is a cimibinadon of 
logically ORed flags, each flag liaving an assexiated mask definetl 
for it. The xlWindowOpen flag will set if the front window is a 
edit or text window. If the xfWindow'Changable flag is set, die text 
in the front window can mcxlified. If the xfl-IasSelection 
window Ls set, then the front window lias ,some text selected. This 
text can be accessed directly from the callback .services routines. 
Tlte xfUseDefault flag allow’s the plug-in to invoke a non-user 
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version, of the [)lug-in. It will only be set if tllc eorretl plug-in 
control flag Ls set, and tile user holds down the option key when 
invoking die plug-ln. In this case, die plug-in should not place up 
a dialog or provide any other user interface. If .settings are 
recjuired, use the default .setting erf the plugdn (what ever you 
want to make them), line xflsBBEditlite and the xflsBBEditDenio 
flags indicate if die RBEdit application is a Uie version (non¬ 
commercial) or a demo version. 1’he la.st two flags^ 
xPJfr'indowHasMailer and xfWindowHasActiveMailer relate to the 
unsuccessful Apple Power'I'alk Mail system. If the 
xfWindowHasMailer flag is set, dien the front window contains an 
PowerTalk mailer. In that case, if tlie xfWindowHasAaiveMailer 
flag is also set, dien the mailer is cunendy active. 

If the plug“in is invoked from an AppleEvent (or OSA 
Script), dien the event and teply parameters are the standard AE 
Event Handler parameters. If the AE parameters aie not NIL (for 
example, if an Apple Event wa.s used to invoke the [ilug-in), then 
die plug-in does not require user interaction (no modal dialog). 
'Ihe script may lx? invoked by someone acrxiss the network. To 
allow the plug*in to lx: scripiable, a standard ‘aele* res<jurc:e with 
tile same ID as the plug-in is necxled in the plug-in file. This 'aele' 
resource can only .support one AE suite, but ain have any numlier 
of events as you warn. Bane Bones Software suggesLs using their 
BBEdit extension suite, 

Extension Control Flags 

The plug-in control flags firtjvides information to die BHKdit 
appliaiLion alxiut your piug-im This information allows BBEdii u> 
determine whether to enable or disable your extensions menu 
item depending on the state of the appliaiiion. For example, if 
the plug-in requires PowerPC Hag is set, then the plug-in will be 
disabled when il is nm on a (i8K Macioiosfi. 

'llie fli-st three flags deal with handling an undoable plugdn. 
Bare Bones Software provides several callback .services dial make 
undoing most text etliitng plug-ins trivial. To signify that tile 
extension know alxjut undoing iPs actions, the undo-.sawy flag 
needs to be set. If the Can Be Undone flag is also set, then 
BBEdit exfx:ci.s your plug-in to use the callback routines to 
handle this. Odierwise, if thi.s flag is not set. wlien the user 
.selects the menu item, an ""Tliis aciitin can not lx." undone “ do 
you wish to confinue?*" alert will ai^jxar when the menu item is 
.selected. Tlie plug-in is only called if the user tlien dicks ^Yes", 
To disable this alert, set die “Can't Undo’" alert flag. 

The next five flags control whellier or not the plug-in is active 
in the menu. Tlie Requires Non-Empty ’Window' Hag indicates the 
plug-in is disabled if diem is no top most window, or if the top 
most window^ has no text in it. The Rec|uires Changeable Window 
indiaites die plug-in is disabled if there is no top mcist window, or 
if the window is read only. The Requires Edit Window requires 
exactly that Ixfdre the plug-in is enabled. Itie Requires Sdeclifin 
flag indic^ales the top most window is there, and some text is 
selected. Ihe Recjuires PowerPC fhg was already explained. 

The last four flags are miscellaneous ones. The Support 
New Interface flag tells the BBEdit application if the plug-in 
support the new or old conventions. Fur this article, I 


strongly recommend setting this Hag, and only using the new 
style. The Use Option Key for Default flag means the user can 
hold the option key down to invoke the plug-in with ihe 
defaull setting. Ihis flag is only supported on the new style 
interface. The Place on “Interner Menu Bag indicates where 
the pltig-irt wishes to be placed in the menubar. Assuming the 
user lias an Internet menu and this flag is set, the plug-in is 
place on the Internet menu. The Is a Tool flag indicates the 
BBEdit plug-in is a BBEdit Tool 

BBEdit Tools are beyond the scope of this article. Tools are 
special plug-ins dial function very similarly to old fashion desk 
accessories. 'ITiey provide dragable, resizeable, floating windows 
that are drawn by the plug-in, and can handle mouse down 
events in the window. BBEdit I'ools also suppon Drag and Drop. 
Finallyj they have access to global memory and are persistent. 
The Rare Rones Software's SDK provides more information, 
including example.s, of BBEdit 'fools. 

Callbacic Services 

BBEdii calllrack services are an essential part of the API. If 
the callback services rt)utines did not exist, then die BBEdit plug¬ 
ins would not be more than applioirion specific FKEYs, Using 
callbacks gives a plug-in complete coniRil of the text in the 
application. All callback roiittnes begin widi 'bbxL\ making them 
easy to identify in your ctxle. These routines use the Pascal calling 
conventions and pass the main fund ion's callback pammeter as 
their first parameter. For example, you pass the 
bl>xtGetCallbackVer.sion rotttine the .single callback parameter, 
and it returns the version nunilxT of the BBEdit API. Using this, 
you can insure which callback ajuiine is available for a given 
versicjn of the applicaiion (trheck the header and documentation). 

Several routines use either windowptrs as pararneters or 
jxiss them as results, 'Ihese are standard Macintosh windowptrs. 
Ihe plug-in itself receives the windowptr trf the top mo.si active 
window. If tlie window's Kind field is of type userKind, tlicn die 
window is a standarcl BBEdit text window. Be aware that diere 
art^ a number erf other window kinds. Use the t:allback routines, 
or the control flags, to make sure your plug-in is only invoked 
when the correct window is on top. 

The first set of callback routines duplic’aie the standard 
feature of the Edit windtiw. Since an plug-in can holli pass data 
into and take data out of the clipboard, this is a good method 
to modify the text in a window. These routines include 
bbxtCopy, bbxtPaste, and bbxtDelete. Other text editing 
nmtine.s include bbxtGetSeIcclkm and bbxtSelSelection which 
can Ix" used to get and set the selectitm of the text in a window. 
The hbxtGetWindowContenT call can used to directly acc:e.ss the 
text in a window, while bbxLSetWindowContent can be used to 
change it. IF you use the bbxtGeiWin<JowConrent call to 
examine the text handle, and then change Uie content of that 
text handle, then you should call the bbxtContenLsChanged 
routine to inform the application of the c:hanges. The bbxtinsert 
call can be used to place text into the current selection space 
of a window. Between these routines, you can control of 
changes to the text in a window. 
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eoAccess* 


Thousands of developers, including America Online® and Claris®, have 
already found that NeoAccess enabled them to build fast, powerful internet 
applications in record time. That’s why there are more copies of NeoAccess 
based applications on end-user machines than any other object database 
backend. Tap the power! 


Cross-Platform Object Database Engine 

NeoLogic Systems, Inc. 

1450 Fourth St*, Suite 12. Berkeley, CA 94710 

V. f- »^iQ.S24-45Q^ neot^gfcQneQiogic.com 


M-Fc^AMtoSPM Pacific: 

For mfbrrnadon and 
Customer Service; 


1-800-919-6353 

1-510-524-5897 


Order Directly from Our Web Site! 

Download the Architectural Overview 


www.neologic.com 


NeoAccess is the most powerful object-oriented database engine available. 
It displays electrifying performance —up to ten times that of its competitors. 
Behind its elegant programming interface is a fully optimized relational query 
engine tuned for short access times and an object cache with automatic 
garbage collection for nearly instantaneous access to previously used objects. 
All in a memory footprint as small as 150K, 

Get the power of NeoAccess, and avoid the expense and administrative hassle 
of feeding the runtime fees meter You pay one affordable price no matter how 
many copies of your application you sell or use. 


Others may promise cross-platform development tools—NeoLogic delivers. 
NeoAccess is a set of C-f-f classes designed for use with popular compilers 
and application frameworks on Windows®, Macintosh®, and Unix* platforms. 
Source code is included so it can even be used with custom frameworks. 


The roLiiincs bbxtGetLastLine, l>l>xiCtHLineNuinber, 
hbxiCctiinePos, hbxTOeciineSrari, and bbxtGetUnehnd can lx: 
used to find iht number of lines in a window, the line number 
of a specific cfiaracicT, the offset of a specific line and the offset 
of a given character from the beginning or end of it’s line. Thest' 
funaions can be iLseful in formatting lines of text. 

Rare Rones Software also provides several file io routines* 
Given Liie file name, volume id and directory id, bbxtGetFiieText 
will load that file into a given Iran die. The bbxtOpenFile call 
loads a text file into a standard edit window, and returns the 
windowpif of tliat window* The biixiGclFolder call displays a 
Standard File dialog for ch(x)sing a folder fl wish the Mac OS 
would provide that call). The bbxtO pen Several call provides a 
Standard File dialog for multiple selections of files (another one 
Apple could do to duplicate). The bbxf New Document. 
bbxtOpenDfxaiment and i>bxtSave calls invfike the same actions 
as if the user liad selected the items from the File menu. Many 
of dicse calls return the WindowFir of the created window, 
which can be then used to view or modify the lexl. You may 
also want information about a given window/file. 'iTie 
bbxLGciDoclnfo call can return die name, volume id and 
directory id of a window/file, while bi^xtGetModDaie rctyras the 
last mrxlification date of the file/window. For iliose wlio wish to 
use Code Warrior or Think projeci files, bbxtGetProjectUst will 
parse these files for you, wliilc bbxtlTojecn’extLisi will generate 
a textual listing of die projea document's conteni* Finally, 


[ibxtOpenFilcByName will open die specified file, using tlvc 
same search logic as ihe ^Open Selection Command”. 

Several user interface calls are available for plug-in developers. 
The .simplest is bbxtReportOSFrror which puts up an alert box with 
the proper OS Error message, based on the OSEnr parameter. 
Dialog management can lx? handled by hbxLSiandanlFiiter (which 
can l>e used as a filter proc for modal dialogs), 
bl>xtFrameDialogltem (whidi draws a rectangle anamd the dialog 
item), and bhxtCenterDialog (which centers the dialog). For those 
who ncx'd to place a Progress Bar window on the screen, 
l)l)xtStaitl^it)gress, bbxtDol^rogruss and bbxtDoneProgress pnwide 
exactly that. The bbxtLConfimiSave providers the siandanJ "Do you 
want to save?" Alert to the plug-in. Bamlkmes Software provided 
this long before Apple thought to add it as a .standaai call to Systeui 
8.0* Finally, bbxtCfeutcRcsults will provide an error browser similar 
to a compiler error window* 'Ihis is the perfect feedback for erron: 
if your extension \s come .son of compiler 

The BBBdit API provides a way for plug-ins to store and 
retrieve plug-in-specific preference data. Using 
hi)xtGetPreference and bbxiSetTTefcrence, a plug-in *sTores Its 
own persistent preference data in the BBEdit preferent:es file. 

As meniioned previously, BBEdit provides a l^uik-in Undo 
feature for plug-ins. If you are going 10 change a range of text 
in the current window, BBEdit keeps track of the ok) and new 
states of the text. First, call the hbxiP reset Undo or 
bbxiPreparellndo routines before the changes start, and then 
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call the l)l>xlSctUncio or bbxtCommitUndo routines after the 
changes are done. BBEdii will then handle undoing and/or 
redoing the text. One set of routines is based on the current 
selection of text, while the other set is based on a given 
seleaion range. 

Other Apple Event, AppleScript and Prtx:ess manager calls 
are available. The bbxtKunScript provides a simple way to 
execute a given AppleScript file, llie bbxtSendApplcEvent call 
allows you to send the AE, and BBEdit application will handle 
die idling phase of the transaction. Simpler Apple Events can be 
generated by bbxiSendOpenDoc and bbxiOpenWidiFinder 
which cause an application or the Finder to open a document. 
The bbxtFinclApplic'ation call uses the Desktop manager to 
locate an application, while the bbxtLaunchAppliauion call can 
be used to launch it. The bbxLApplicationKiinniog call can tell 
you if that applic'ation is already running. 

Finally, several routines provide pattern sc-arching and Grep 
feaaire for dte plug-in, Tiie bbxtFindPattem cal! does exactly that; 
it searches some text for die given text pattern. A host of Grep 
calls (bl)XLPrepareGrep, bbxtDoneGrep, bl^xiReptirtGrepError, 
bbxiGrepSearch, lihxlGrepRepleace) provide direa control of all 
the features of a standard Grep search and replace* 

The ILst of callback routines evolved over time, and it shows. 
These are routines that re^il plug-in developers needed, rcc|uested 
and received. Bare lk>nes Software has been successful witli 
marketing their product as web designer tool based on how well 
die HTML plug-ins are designed. They could not have clone this, 
unless the SDK that comes with BBEdit was also a success. 

Examples 

The first example provided here demonstrates a gexx! way 
to display about or help informaiirrn for your plug-ki. After a text 
restjurce is loaded and detachcxl, the bbxtNewDocument call 
aeates an edit window. 'Ihen the bbxtSetWindowGmtents call 
sets the window contcni to a given text handle. This will place 
a simple window, containing die text, for die user to view. 
ResEdit was used to create the required resource with the given 
Dags set. Notice the EnterCode Resource and the 
ExitCodeResoufce calls, wtuch arc retjuired for code resource. 

Ustina 1: Ablaut MacTcch EKampto c 

Main 

// About MacTcdi ExampJes.c 
// by Steve Slice i $ for MacTcdi M^gazi ne 

// Sample of tJULdit cxtcji.slon 
// 

// Kcquirrii ‘BBXF" Rcschiitc 128 witb Support New [nteiticc, 

// amt IJodmSavy flags set 

// Also requires ‘TEXT Rcsoim:i: 128 whidi contains 

// ‘MacTeeh BBEdit lixampks by Stnc Sheets’. 

// Required includes 

^include <Externanntorfaco.b> 
ffinclude <A4Stiiff,b> 

// Main emry of extension 

pascal OSErr main(ExternalCallbackBlock ‘callbacks* 

WindowPtr w* 
long flaga. 

AppleEvent 'event, 

ApplcEvent 'reply! 


I 

OSErr a_tesult = noErr; 
yin dowF t r a_¥ind ow_pt r; 

Handle a_text_hdl: 

// SnulQUI 

EnterCodeResourceD; 

// IjoadText 

a_text_hdl ^ GetRenourcef'TEXT** 128!: 

// H have Text, detatch it 

if (a..text_bdH=NliLL) I 
// DetatchText 

DetacbResourceCa. tfixt_hd l) : 

// Cieatc new window 

a_window_ptr " bbxtNewDocuinetit (callbacks): 

// TfWindow^ comxi 

if (a_wiiidow_ptr !“NULL) I 
// Set Content (must not dispose bandte then!) 

bbxtSetWindowContents(callbacks* a_wlndow.ptr* 3_tcxL_bdl!- 


// Dispose Text (if can not create new I>txr) 
else 

DisposeHandle(a_Lext_hdl]: 

1 

II Finish call 

ExltCodeResourceO % 

return a.result: 

I 

The second example demonstrates how to examine, and 
then modify the selected text inside an editable text window. 
The routine copies the selected text using bbxtCopy, then the 
copy is modified. Modification for thi.s extension consists of 
stepping tlirough each charaaer, shifting it to upper or lower 
case. The first shift decides whether or not to change the 
remaining text up or down. Then the hi>xtPaste changes the 
text in the current selected window. Notice the 
bbxtPresetUndo and hhxiSetUndo calls are used to allow this 
plug-in to be undoable. 

TJsting 2:Siiifl Uppcncasc/Lowercasc.c 

Main 

// SJufi lippcrcast/Lowericasc.c 

// by Steve Sheets for MacTech Magaismi' 

// Sample of BBEdit extensioo 

n 

// Requires ‘BBXF' Rcsotuve \ 28 with Support New Ttiterf^c, 

// OfldmSavy. Requires OLmgeable Wimlow. Qui Be Undeme, 

// and Requires Selection flags set. 

// Requited includes 

Jinclude <ExternalInterface*h> 

^Include <A4Stuff.h> 

^include <Sound*h> 

// Main entry point of extensjem 
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pascal OSErr tnain(ExterTifilCalIbackBlock •callbacks, 

WindowPtr v, 
long flagst 
AppleEvent ‘event* 

ApplsEvent * reply) 

i 

OSErr a_resiilt noRrr; 

Hand1e a_text_hd1: 
long a_length: 
char a char^ 
long a. count: 
short a„starus = 0: 

// - Case Unknown, I ^ shift t<^ UppetZ' sliiri lo Uwer 

// Sian Call 

BnterGodcResource{)i 

// Copy Srlcciicm 

a_text_iidl ** bbx[Copy (callbacks): 

// Check ft is noi null 

If fa_texOdl!=NUU) I 

a_leiigth ■ GetHandieSize(a_toxi„bd1); 

If (a_1cn£th>0) I 

// Sei LIndoabtc 

if {bbxtPresetUndo(calIbacks)) t 

// Sci status 0 (unknown) 

// t indicates to shift Itjwcr case lo upper 
// 2 imliort^ to shift upper ease to lower 

a_status " 0: 

// bK>p thiouddi ail the text, char rime 
HLock{a_t€xt_hdi): 

for (a count = 0: a_count<a_iongih: □.countHf) I 
a_chsr * * [‘a .text_hdi+a_couiit): 

// If status is noi SCI 

if (a_statos“0) I 

// I f char is lower case, set status ii> Upper 

if {{fl_chflr>^'a") && Ca_char<='K‘)) 
a_siatus = 1; 

// If char b upper case, set status to lower 

olse if ((a_char>='A*) && (a char<='Z’)) 
a statue = 2: 

I 

// If cliar is lower & state is Upper, shift it 

if (a_status—1) I 

if (Ca_char>“*a') H (a_char<='z')) 

• (‘a_teKt_hdl+a_coynt) = a char ' "a* *A1: 

I 

// If char is upper & stale is Itjwer, shift It 

else if |a_st3tus”2) I 

if ({a^char>-*A‘) U char<='Z')) 

* C'a_text_hdl+a_count) = a .char ^ *A* + 

i 

I 

ftUnlock(a_text.hdl>: 

// Return results 

bbxtPaste (calXbacki^, a_(.Gxt_hdl): 

// Set Untloahle 


Developer Tools to Support 

Adobe Adobe® Tech nologies 

Adobe provides a complete set of tools and 
services for your developmeni needs. Whether you 
want to integrate Adobe Acrobat® capabilities into 
your applications, add PostScript® longuage 
support to your products or create powerful 
Graphics Application PiugHns, Adobe has the tools. 

These Software Development Kits now available: 

^ Adahm Acrobal Plug-Ins 
^ Adoba PostScript Uinguogo 
^ Adobe Ph€»toihop<& 

^ Adobe lllustrator<& 

^ Aciobe Preni»er«<& A Adobe After effects® 

9 Adobe PogeMakor® & FrameMokef® 

To hove informotion faxed to you< call (206) 628-5737 
and request document 1220. Or visil our web page: 
htfp://WWW.adobe.com/supporlservice/devrebtions 


Adobe Developers Association 

345 Park Avenue. San Jose, CA 95110-2704 


bbxtSetUndo(callbacks): 

) 

// Dispose Text 

DlsposeHandle(a„text_hdi): 

I 

// Rnishcall 

EKltCodeResourceO; 
return a_tesult: 

I 

Thf Last Word 

While BBEciir is a ircnicndously powerful and feature rich 
tool* perhaps it's finest selling point is the insight and humility^ 
of The Bare Bones team in realizing Ltiai Uiey couldn't imagine 
or provide all the feamres every user would require — so they 
provided us with ihe option to add our own features. TheyVe 
given us the chance to make RREdit i!tc perfect tool for each of 
us. Hopefully, this brief survey of the plug-in archtteciurc for 
BBEdi! will help you to begin the challenge of tuning the 
power of BBEdit to the demands of your (Twn work, ffil 
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PLUGGING 


by f(>e Zohhiw 


A Simple Plug-In Example 


How to add plug-in 
support to your 
application 


youVe ever used Adol^ Plioiosliop, 
liypcrCard, or even the latest version of 
Metrowerks’ Code Warrior youVe made use 
of plug-in technology Plug-ins are simply 
execulal)lc (xxie (and resources) tliat 
reside in a file oilier than tliai of tlie 
application itself. Applications t:an IckkI 
plug-ins dynamically at run-time and 
Ixmefit horn the firnciionality they provide. 

For example, Fliotosliop is a high-end 
graphics application that alU)ws you to 
load an image and manipulate it in any of 
a number of inleresiing ways. You can add 
a drop-sliadow, change die color balance, 
I>roduce lighting effects, and more by 
using special. Mutii of this funcdontility is 
provided by plug-ins, known in this case 
as PhoUishop Filters. When you launch 
the Photoshop applieaiion, if scans a 
folder in the same folder as iLscIf named 
“Plugdns" for Hies of a s[Decific type. As it 
finds these files it makes their functionality 
available from within the prtignim by 
displaying them in the Filters ttientu 
Selecting items from rhi.s menu invoke the 
appropriate plug-in and extend the 
capahilities of Photoshop. 


Yt>u might ask yoiirself, why would anyone want to write 
dozens of separate plug-ins if they are just going to l>e used 
from within an application anyway? The reasons are simple. By 
extracting certain functionality into plug-ins, you can easily 
update or add new features to an application without changing 
the application itself. For instance, to acid a new filter to 
Photoshop, you simply drag it into the Plug-ins folder and 
relaunch the application. This not only allows Adolx^ to easily 
manage tlieir sohw'are, hut it also allows hundreds of tliird- 
party developers to enhance and customize the Photoshop 
application by writing Photoshop Filters to the Adobe- 
publislied specification, all without having access to die source 
lxkIc of Phoioslio]) itself. 

Given these examples, you c’an see that using plug-ins can 
not only help ease the burden of development, but it can also 
help your salespeople by milking your application more 
acces.sible, more customizable, and more appealing to your 
customers. Irfs ltK)k at an example of how you might 
implement j>lug-in .suppon in your application. 

Basic Pi og-in Support 

Tlie following example shows you the most basic steps 
required to implement plug-in suppon in an application. We 
have implemented a simple PowerPC application that loads a 
simial plug-in, in our ai.se compiled as a PowerPC shared 
library, and executes code within it. Once you understand 
liow ihis application and plug-in work together, you can easily 
extend the sample and devise your own plug-in architecture 
for your application. 


Joe Zobkiw <zobkiw0rriplesoft.com> Is a prognmuner, auilior musician and pnicticing carver of stone, tie us the author of A 
Fnigmcnt of Your imagination, a book about code fragments and code resources for iJie Mac OS. You can learn more about 
(and order a copy oD tlie Iniok at <hn:p;//www.triplesoft.com.d'ragmeni/>. 
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Plug-in Example ^ jilS 

2 items j 196.8 MB available 

Application Shared Library 

A 

4 ► 



Figure L 


For I his projcci wc are using Code Warrior Professional 
Release 2. Our shared library is written in C and our 
application is C++. We started out by creating a single project 
file that contains both targets for this [)roject, the application 
and the shared library, The project is set up so whenever we 
build the application, the shared libraiy^ will be Itroughi up to 
date if need be. You do not need to have hexh of your targets 
in the same project file. However, Code Warrior Professional 
Release 2 allows us to do this and it makes it easier for this 
particular projec:L 



Shared Library jc 
Shared Library Re sour me 


n/a n/a 

n/a n/a 

164 IC 

im 5K 


10 fil^s 


199K 64K 
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MkLinu 

Microkernel Linux for the Power Macintosh 




Mk Linux is a complete system,, based on Linux 2 and the 
Mach 3 microkernel. It includes development tools (gcc,, 
gdb^ perl,...)/ X11R6.3^ and hundreds of other commands. 

MkLinux builds and runs most Intel-based Linux software. 
It works efficiently and reliably on a wide range of Power 
Macintosh platforms. Visit Apple Computer s MkLinux web 
site (www.mklinux.applexom) and Prime Time Preeware's 
web site (www.ptf.com) to find out more about MkLinux! 

MacPerl: Power and Ease 

MacPerl is a robust and powerful port of Perl 5 to the Mac. 

It runs under the Finder and MPW, supports Apple Events 
and Toolbox calls^ and is generally quite nifty! For detaib 
on MacPerl and associated products (book, CD, etc.), visit 
the MacPerl Pages (www.ptf.com/macperl). 

Prime Time Freeware mfo@ptf.com 

370 Altair Way, #150 (408) 433-9662 

Sunnyvale, CA 94086 (408) 433-0727 fax 


When die project builds Ixith the application and tlic .shared 
library, it prtxiuce.s two hies. One is an application [}n>grani named 
“Application" and die otiier is a shared library named ‘'Shared 
Library.” Wlicn die application is launchaf it prompts the u.ser to 
enter a value for inBeepTimes, Upon entering tliis value, the 
application aiieinpLs to open die shared libraiy^ by name, llnd die 
expoited OisplayDialogAndBeep funaian by name, and t:all the 
hinction. If diese steps are compielcd successfully, die computer 
will Ix-cp and you will see a dialog box as followst 


Figure 2. 

Before you dc.sign an application to call a plug-in you 
must decide on the calling conventions. In this simple case we 
have decided to implement a single function in our shared 
library that will be called from die application. We are calling 
our function DlsplayDSalogAndBeep. It is called with one 
parameter, inBeepTimes, which represents The number of limes 
to make the computer beep while displaying a dialog, it is 
defined a,s follows: 

Uniting 1 

OSErr DisplayDialogAndbet^r{long inBccpTlmes): 



Now beeping 9 times from 
within a shared library. 


Figure 


Let’s kx>k at tile shaied library to see how it is created, then 
we can see how the application is lused to call This ct)de. First, it 
is important to understand that a shared library is simply a file 
that coniaias a code fragment (Pow^erPC code) in the data lock. 
If you are not familiar with code fragmeni.s and the Code 
Fragment Manager, you will want to read atxiut them in Inside 
Macinto-sh, You can do so at <http://devworld.apple.com/>. 
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DisplayDialogAtKiBeep 


i he compiler handles most of the details for you but you 
want Uj make sore that your projed is set tip to export (at a 
minimum) the functions that you expect to be able to call 
from your application. If the functions are not exported, your 
applicalion will not be able to access them. Other than that, 
a shared library is not much more than a bunch of functions 
without a required mein() entry point as you are used to 
seeing in applications. 

Another interested and useful feature of shared libraries (and 
any code fragment for tliat matter) is the ability to include a start 
function, similar to main(), the main entry point of the ctxle 
fragment. You can also include initmlixaiion and termination 
functions. These are called when the code fragment is first 
connected to and when the connection is closed, respectively. 
Our plug-in makes use of die initialization and termination 
Rinctions to insure that c?ur shared lihiary resource file is 
available so we can access our dialog box. 

You do not need to use the initialization and termination 
routines in this way. In fad, you can use them in any way you 
choose, or not at all I simply found it convenient to locate the 
plug-in file given the CFraglnilBlockPtr that is p^issed into the 
initialization routine in this case. 

ibe required code of the shared libraiy, sans comments, is 
as follows: 

Listing 2 

<CodeFragmentfi.h> 

JfinclLide (MlitedMode.^) 

fine hide <ConditionaIMacros.h> 

ijfinc] tidfi CKound.h) 

Ifinclude "Shared Llbrary-h” 

enum f 

uppDiBplayDialogAiidBeepProciInfo kCStackBased 
I RESULT SIZElSlZE CODEt.^izeof(OSErr))) 

I STACK ROUTINE PARAMETER fL STZK_C0r>R Csliseor {long))) 

] : 

short gFllcRerNum; 


OSErr _hiititilizi?(Cl-raglnitBlockPtr ibp) 

( 

OSKtt err = noErr; 
gFileRefNum ^ *1: 

if (ibp->fragLooaror.wtiGre = ktlaiaFotkCl-'ragLooator) t 
gF1iGRafNum = 

PSpOpenReaFilE(ibp >fragLocator.u.onDisk.fileSpec. 
fsHdPerm) r 

if (gFileRefNuin = -I) 
err = ResError{): 

1 

return err: 

3 


_tt-miimtc 

void _.lerininaLe(void) 

I 

if (gFileRefNum 1= *1) 

CloEeResFilG(gFlleRGfNuin) : 

1 


OSErr 0i sp1 ayDialogAndBeepdoii^ inBeepTitnes) 

I 

DlalogPtr d: 

Str32 sBeepTimes: 

long i: 

uaslgned longsometicks: 
short saveResFlle: 

saveResFile “ CurReRFile{); 
naeResFneCeFneRefKum): 

NunToSl ringCinBeopTiiiiGs, ssbeepTiiiiGH} r 
ParamText(sBeepTimes, "\p” , p”. "Vp"): 
d ^ CGtNewDialogt256. nil. tWindovPlr)■1): 
if (d) I 

ShovWiTidow(d); 

BrawDialQg(d ); 

} 

for (1 = 0: i < tnBeepTimes: ++i) [ 
flaatiMenuBarCO) ; 

SysBeep{0); 

BelaydS. ^someticks) j 
FiashMenuBar (0): 

Delay {15. Sisometlcks); 
i 

if Cd) 

OisposeDialogtd): 

UsekesFile(saveResFile): 
return noErr; 


That's all there is to it, believe it or not, 

Tlie shared library isnT too useful on its own, It needs the 
application to c^dl k in order for it to do anything, basically the 
application first needs to locate the shared library by name. We 
call GetSharedLibrarvO in order to do this. By passing in the name 
of die shared librar}' we are looking for, the Code Fragment 
Manager will autoniaticatly look in the same folder as our 
application first, then proceed to look in the Extensions folder 
and the System folder until it either finds a shared library' with 
the correct name or it fails. If found, GetSharedLibraryO will 
automatically open ii connection (and execute its initialization 
routine menlitined earlier) to the shared library. 

Once we find the shared library^ and connect lo k we can 
then query it for an exported symbol named 
DisplayDialogAndBeep, In this case the symbol is an exponed 
function but it mighi also Ixf cxfiorted data. If found, we can 
continue by creating a routine descriptor for tlie function by 
calling NewRoutineDescriptorO, calling it by using 
CallUniversafProcO, and uliimaiely disposing of the routine 
descriptor using DisposeRoutineDescriptor(). 

Another way to call your shared library (or any code 
fnigmenl for dial maticT) is by means of a main entry point, 
sometimes simply called fnain{). Under die (^(1x0 architecture that 
was the only way to communicate %vith a code resource. The 
code resource had a main entry point that you would call using 
a selector-based mechanism. That is, the main entry fxiini would 
expect a selector {a unique identifier) to distinguish the purpose 
of the call, anti then extra data, possibly in another parameter, to 
act on during that call. This teehni(|ue alloWnS the aiilcT to not 
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need to know specific exported funaion names, it can simply 
call through the main entry pf.>int, pas^sing tlie correct selector 
and data, A sample main entry point might look like this: 

OSErr malnClong iriSeleclor, void* ioDataPT r); 

Another might use a single parameter block for all of tha 

data, including the selector itself, 

QSErr main(HyParameterBlock- ioPatamPtr); 

During the call to Cal(UniversalProc() is when the 
DisplayDialogAndBeepO function in the shared library will lx: 
called. It will be passed the parameters we specified, perform its 
duty, and return a result code. If you specify the universal 
procedure pointer incorrectly you wall undoubtedly crash your 
computer during this call. 

You can find more infonnation about universal procedure 
pointers and routine descriptors in the Inside Macintosh chapter 
on the Mixed Mode Man^iger at <http://devworld.applexom/>. 

Once the call returns, tlic coimcction to the shared libraty is 
closed by calling CloseConnection(), At this time is when the 
termination routine in the shared library is executed. 

The reejuired ctxie of the application, sans comments, is as 
follows: 

Listing 3 


ExccuLcSharcdiib 

OSRrr RKeciiteSha redLib(long inBeepTimis) 
f 

OSKirr err "" coFrr. ^ noErr: 

CFragCQnc^?ctionlD cotinlD = 0; 

Ptr mairiAddE: = nil: 

Str235 erri^ame: 

err = GatSharedLibrary{’‘\pShared Library", 
kPoverPCCFragArch♦ 
kPrivateCF ragCcpy, 

^connlD. StuiainAddr , GrrMaiie) ; 

if (err = noErr) I 

Ptr symAddr = nil: 

CFragSyroboiClass symClass: 

err = FindSymbcl (connID, “\pDisplayDialogAndBeep'*, 
^syniAddr, &symClass): 
if (err “ noErt) ( 

OnlversalProcPlr upp “ 

NewRoutineDescrlptor[(ProePLr)symAdd r, 
uppDxspiayBialogAndBeepfrocinfo, GetCurrentTSAC)): 
if (upp) ( 

err = CallUniversalPrcc(upp. 

uppDisplayDialogAndBeepProclnf 0 , 
inBaepTimes); 

DlsposekoutineOescriptartupp); 

1 else Gcr = memFLillErr: 

1 

err2 - CloseConnection(&CQniiID): 
if (err = noErr) err - errZ; 

} 

return err; 

I 


ITiat's all there is to rhai f,<K>, believe it or not. 


StoneTable 

You thought it was just a replacement 
for the List Manager ? 

We lied, it is much more ! 

Tired of always adding just one more feature to your LDEF or 
table code ? What do you need in your table ? 

Pictures and Icons and Checkboxes ? 
adjustable columns or rows ? 

Titles for columns or rows ? 

In-line editing of cell text ? 

More than 32K of data ? 

Color and styles ? 

Sorting ? 

More ?? 

How much longer does the list need to be to make it worth 
$200 of your time ? 

See just how long the list is for StoneTable. 

Make StoneTable part of your toolbox today ! 

Only $200,00 MasterCard & Visa accepted, 

StoneTablet Publishing 
More Info & demo Voice/FAX (503) 287-3424 

http://www.te!epon.com/^stack Stack® teleport.com 


Enhanced Pixtc-tn Siipwirt 

Plug ins Folder 

The above example assumes your appUcarion knows the 
name of the plug-in lx:forc ii is launched. However, in order 
to implement a Photoshop-siyle approach to plug-ins you need 
to be able to search for the plug-ins at run-time. This can he 
achieved using a very useful sc^orce code libraiy' called 
MorcFilcs !>y Jim Luther. 

MoreFiles allows you to {amongst numerous other features) 
easily scan a folder for files and c'all a specific function as files 
are found. Using this technique you can quickly locate ail plug¬ 
ins that your application can use and add their names to a menu 
for your user to invoke as needed. MoreFiles can l>e downloaded 
from the Internet at <ftp://dev.apple,com/devworld/S3nnple_Code/Fi[es/> 
or <http://members.aol.com/junnplong/>. 


Want to share a tip with the 
community and get paid for it? 
Send it in to 

<mailto:tips@mactech.com> 
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Callbacks 

SomcLliing else u> try is exporting Pimctiofis from your 
application and having your plug-in call them, just as the 
application calls the functions in the plug-in. These are called 
callback functions Ix^cause the plugHn is “aillmg back"" into the 
application. These types of functions can be very useful in 
providing information to the plug-in as it is needed. For 
example, the plug-in t:an query the application to see if‘ it has 
enough memory available in an internal buffer to handle a 
specific task before setting off on the task. 

Iini>ort Libraries 

You can also compile your shared library in the form of 
an import library. Ry doing this you can simply include the 
library in your project niucb like you would Tnierfacehih. This 
way, you can easily call the exported functions in the import 
library without having to worry about the details of locating 
the library file, locating the exptmed funaion it.self, and 
creating a universal procedure pointer. This may defeat the 
purpose of considering plug-ins in the first place, since the 
library is '"linked” to your project. Another option, however, is 
to use the “weak link" option. Weak linking meets you in the 
middle of creating a full-Hedged plug-in and “strong" linking 
to a library as described earlier. See your development 
environment documentation for details. 

Fat Plug-ms 

Calling a plug-in fat simply means that it can run natively 
on more than one microprocessor A fat plug-in might contain 
ccxJc for both 680x0 and PowerPC microprocessors within the 
same file. Titis allows users to install just one file on any 
Macintexsh computer and obtain the Ix^nefiLs of optimized code 
for their specific computer. You can easily compile and meige 
both 680x0 and PowerPC code in this manner An informative 
lxx>k written on the subject (if T do say so myself) ctwers this in 
great detail. You can learn more about this technique (and other 
Lcchnic|ue.s mentioned in this anicle) from A Fragment of Your 
Imagination at <http://www,triplesoft.com/fragment/>. 


What About SOM? 

SOM is IBM's System Objea Model It was originally 
introduced on the Macintosh with OpenDoc; Although 
OpenDoc has moved on, SOM has stuck arf>und. The Mac OS 8 
Contextual Menu Manager uses 80M, for example. SOM allows 
you to use object-oriented techniques in a shared library, You 
gamer all of tlie advantages of being able to create and override 
classes (including special 80M base classes) with the advantages 
of coding a shared library. Depending on your needs, SOM may 
be somctliing you will want to explore. 

For more information on SOM, see the February 1998 issue 
(jf MacTech magazine which contains articles on SOM and the 
Contextual Menu Manager. You can also find information on 
Apple's developer web site at <http://devwor[d,applecom/>. 

What About COM? 

COM is Microsoft’s Component Object Model. It is a 
programming model that defines how objects can communicate 
with one another, similar but different to SOM. ActiveX controls 
(previously known as OLE controls) are based on COM. For 
more information on COM and ActiveX read the June 1997 issue 
of MacTech Magazine. 

CoiVCTAISlON 

Once you understand the bask concepLs descril^ed in this 
article, you will begin to find new uses for plug-ins in your 
application. Many applications have areas that can be logically 
broken out into a pliigdn architecture. The key is to understand 
and then experiment. Don’t u.sc tliis approach if you don't need 
it, but if you do, you can easily add years of life to your 
appliaition by opening it up to yourself and third-party 
dcve]o|XT,s in this way. I look forward to hearing atioui h<m 
you’ve used thi.s introductory plug-in architecture. 

Special Thanks 

Sfx'ciai thanks gc>es to our technical rei/iewets: Tantek Celik, 
Nick DeMelkK Eric Gundmm and Marty Wacbier. 

m 


Want to get Mac OS developer 
news delivered to you? 
Subscribe to MacDev-1™ 

A subscription form is available 
through a link on the 
MacTech home page 
<http://www.mactech.com> 
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TOOLS OF 
THE TRADE 


by Jeremy Nelson 


Libraries on the Mac 


An overview of shared 
code mechanisms on the 
Macintosh 


like the compiled code of the source you have written. 

Most programs include some statically linked libraries. These 
libraries may provide language specific functions, basic 
Macintosh calls or mathematical functions. 


Lil:>rarics — precompiled collections of 
code — are a powerful tool for 
programmers, lliey allow us to distribute 
valual)ie lc\:hntjlogies without disclosing the 
secrets of the proprietary source code from 
which those libraries were created. Because 
libraries are precompiled, they also 
encourage users of the technology to treat 
them as a black box — letting the user focus 
on their own code without worrying hfjw 
library accomplishes its purpose. Tills article 
will survey library mechanisms on the 
Macintash and offer a brief overview of the 
advantages of caciu 


Staticaij.y Linked Libraries 

Libraries can l>e linked to other code 
statically or at runtime. A statically linked 
library, like code you have written 
yourself, is integrated into your 
application's binary during the compilatlo!i 
process. In contrast, a runtime library is 
loaded when the application executes, and 
calls made to tiie library are redirected to 
the loaded code. Both kinds of libraries 
are a gcxxl way to share new technologies. 

Statically linked lil)raries are made up 
of a [^recompiled binary and an interface file 
which contains tlie API. Using a statically 
linked library Is easy, simply inelude the 
binary and tiie C header file or Pascal 
interface file. During tiie linking stage of 
compilation the binary portion of the library 
is integrated into your a(>plication, exactly 


RimiME Libraries 

Runtime libraries, also known as Dynamically Linked 
libraries (DLL), can reduce disk usage and lower memory 
requirements by allowing different applications to share a single 
copy of the ccxle. Runtime libraries can also allow portions of an 
application to be selectively updated by simply replacing an old 
library file with a newer one. 

Like statically linked libraries, runtime libraries aa; composed 
of a binary and an interface file. However the binary is simply a 
stub library which contains the names of the functions and 
version information. Mercifully, exactly how tlic functions are 
made available to your program when the program is executed is 
hidden from you. During your programs initialization phase, 
when your program Is toeing readied to execute, the Operating 
System prepares any Shared Libraries you reference. 

'iTere are a variety of Shared Library mechanisms on the 
Mac, each with strengths and weakness. T'his diversity of library 
mechanisms exists laigely due to historical faaors. The fonnal 
library mechanisms are: 

• Apple Sliarcd Library Manager fASLM) 

• Code Fragment Manager (CFM and CFM-68K) 

• System Object Model (SOM) 

For completeness, any discussion of shared code 
mechanisms also needs to include: 

• CDinjK)nent Manager 

• Code Resources 

Custom mechanisms arc also perfectly valid (if possibly 
application specific) ways of sharing code. Creating a custom 
mechanism allows developers to tailor a solution, but ar the risk of 
recreating already tried and tested ccxle- a somewhat ironic result. 


Jeremy Nelson is a programmer and Teduiical Support Droid for Slairways Software Pty Ltd. 
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Apple Shared Ijbrary Manager (ASLM) 

A.SMVI \s ihe om of tfrc oldcM solutions fn>m Apple and it 
works under 68K and PPG. Unfortunately you can only make the 
libraries with MPW. While ASLM is available on every Mac and 
fairly siraightforw ard to use, very I it l ie uses ASLM besides Open 
Transport 68K. Most progrannners will never use ASLM directly. 
Example: OpenTraasport 68K. 

Reference: ASLM Developer's Guide, Developer CD Series 
Mac OS SDK. 

System Object Model (SOM) 

SOM was dcvclojx:d by IBM to work on their AiX systems, 
runs under OS/2 and was ponecl to the Mac as part of the 
development of OpenDcx'. SOM is both PowerPC and 68K and 
is proijably Lite most technically advanced solution on the 
Macintosh. It is also a deprecated technology and as such it will 
probably not progress in the ftiture. 

SOM provides a numl)er of desirable features. Il can fiandle 
different ealling conventions IxHween caller and callee, and there 
are standird ways to patch and unpaich the code dynamically 
(so you can intercept a library call with your code). It even 
tackles the so-called Tragile base class’ problem and other 
changes to the interface of a library. SOM provides the calling 
program with hill Object Oriented class libraries, even translating 
acrass dilTereni compilers' Ol)ject implemeiitatitms. 

While SOM is a technically wonderful solution it is a 
complex technology wiiich has l>een quite difficult to use. 
Development tools have nt)w reduced this difficulty sornewliai. 
SOM was deprecated along with OjxmDoc. 

Examples: Opendoc and Cylierdog. 

Reference: SOMobjeiis^*^ for Mac OS, Developt:r CD 
Series Mac OS SDK. 

Code Fragment Manager (CFM and CFM-68K) 

CEM was made specincally for PowerPC; w lien the P{>werPC 
system came out there wa.s no native shared library, so Apple 
developed a PowerPC native li}>raiy formal CFM Is used by both 
ASLM and SOM tt) load code fragments on the PowerPC. 

In 1994 CFM was ported to 6HK to provide a universal 
solution. CFM-68K had stability problems which discouraged its 
use for .some time. This was fixed in version 4.0 of CFM-68K in 
Novcmlxr 1996 (as described in Technote 1084). 

lb use CFM-68K you need to use different versions of the 
runtime libraries, specially imxlified to work with CFM-68K. This 
makes your apfilication a ‘CFM-68K application’, and you need 
to lx careful about using custom preemptive threading methods 
(this problem relates to the version 4,0 bug fix mentioned 
above). (It Ls pcjssible, luit tricky, to call CFM-68K code from 
classic applicatioas. See Technote 1077 for details.) 

CFM is Apple’s announced direction in shared code. I'here 
arc goexi development tCK)ls h>r CFM in Ixxh CtxleWarrior and 
MPW. !]' you were developing a library for a PowerPC a[>plication 
this should be your preferred choice. Under 68K some developers 
may Ixr discouraged from adopting CFM-68K applications beemse 
of llic changes necessary to their applit:ation. 


Example: OpenTransport, MatliLib, AppearanceLib. 

References: IM PowerPC System Software, Chapter 3: 

Cbde Fragment Manager. 

COMFONBNT MANAGER 

Ibe Compernent Manager was written by the QuickTime tom 
to meet their need for a iinivei^al plug-in architecture. As a result, 
the Q)mponcnt Manager is available under lx>th 68K and PPC. 

Components are code fragments with a particular type (like 
File Types in the file system). All components of tlie same type 
have the same interface. This allows applications to chose from 
a list of different code fragments, each of which may have 
different behaviour, but can be loaded and used identically. This 
is e<iuivalent to having multiple different versions of a single 
library, each with different performance characteristics. 

Components can also be capaired which permits Functions 
to be overridden and nuxlified. A captured component is 
removed from the list of available components, but can still be 
called by the capturing component. 

The drawback is ihat this added versatility introduces 
additional complexiiy. A[:)[>lications must deal w4th selecting and 
loading the component: the code is not loaded automatically 
when the program is being loaded. 

QuickTime Ls the most obvious user of the Component 
Manager. An interesting user of the Component Manager is 
internet Config. When Internet Config was written this was the 
only st)lution which worked well under PowerPC and 68K, and 
provided die override functionality, which was a desired fetiture 
of Internet Config. 

Examples: QuickTime, internet Config. 

Reference: IM More Ttx ill x>x, Cliapter 6: &xTi|x>nent Manager. 

Code Resolikces 

The most common examfdc of code ^sources are List 
Definition Functions (LDEF), Window Definitions Functions 
(WUEF) and Control Definition Functions (CDEF). These are 
Functicins which are loaded using the Resource Manager. It is up 
to die prograriimer to define the API and the prc:)gram is 
responsi)“jle for loading and unloading the code. 

Typically Code Resources only have a single entry j>oinl 
(function call) with an aigumeni which selects the actual function 
and a small number of otiier arguments, often contained in a 
parameter block. Which values are extracied from tlie (laninieter 
bkx:k may depend on w'hat function is called. 

Code Resources have been used in a number of applications 
and good example code Ls available. For instance, on tfic Code 
Wjirrior Pro 2 CD, the “Pa.scal Qide Resources” shows how to 
create 68K or PPC code resources, either of wliich can be called 
from both 68K and PowerPC applications. {'Fhis is a useful way 
CO update time-critical portions of a 68K applic:aLion to run under 
PowerPC wiihoui updating the entire application,) 

Examples: LDEFs, CDEFs, Codewarrior Plug-las under 6BK. 

Reference: IM More Foolbox, Chapter 1: Resoume Manager. 
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Dangers 

Prol:>ably ihe tiuisi confusing thing alx)ut libraries is thiit tlie 
liinary can be compiled using a variety of different cxjoipiier 
options- I'hus there are usually many different vcrsioas of any 
given library. For a splendid example of tliis, kx^k in Codewarrior’s 
MSL C;Bin folder There are over a dozen different versions of die 
Metrowerks Standard C library (MSL C for 68K). 

You need to make sure you include die appropriate version 
of the library in your code. You will not always get compiler 
warnings if you include the wrong version, and some 
mismatched program/library compiler settings can lead to 
inLcrmiitcnt errors wliich may be very' difficult to debug. 

Tliere are several common compiler options unitjue to 68K 
which result in dilTerenr versions. The main settings include: 

• Near or Far: Under (}8K calls to functions can use so called 
‘Near’ or ‘Far’ references. 

• 21 or 4i: Twc} or four byte integers. You need to be careful 
here since it is easy to inckide the wrong version, you will 
not get an error when the application is t:ompiled, and it t:an 
result in olxscurc bugs which are hard to track down. 

The PowerPC Runtime Archirectuie Is much moat precisely 
defined than under 68K. For example, under PowerPC all code 
references use die same convention and all integers are four bytes. As 
a result there are usually many fewer versions of the lYiwerlY". library. 

Different compilers can also generate different 
implemenUilirms of die same library. Tliis is because tlie calling 
conventions for the functions (such as how the fLinction parameters 
are ordered on the stack) are not generally defined tiy die language 
it is up to the compiler vendors to choase. One good way 
around diis is to export functions u.sing the ‘pascaf keyword. The 
Pascal calling conventions are well defined, so libraries compiled 
this way will work under differemt coiniiilors and with different 
languages (all other options being equal). 

It is also advisable to avoid the int' integer type in the liixary 
interface, instead use ‘Int lh’ or 1n62’. Tins gives more robustness 
across different compilers, languages and environments. 

Conclusion 

Libraries provide conceptually clean interfaces to code, 
which can \je well tested and refused. They can also lower 
compile time and allow large projects to lie factored into smaller 
chunks. Runtime lilinirics provide additional benefits such as 
reduced disk and memory overhead, plus they can provide novel 
functionality through dynamic patching. 

On the Macintosh under PowerPC the Code Fragment 
Manager is Apple’s announced direction in shared code, has 
good tool support and is relatively easy to use. CFM is 
guaranteed to exist on all PtiwcrPC Macs. 

Unfortunately CFM-68K requires additional effort on behalf 
of programmers who wish to utilise CFM-68K libraries and CFM- 
68K support is not always present t>n older Macintoshes. For this 
reason Code Resources are often used as a relatively 
straightforward library meclianism. 

Hi 


Stop reading hex. 


Save time with 
Quadrivio General Edit, 
the fast way to edit data files 
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Defiite your file format 

• Easy, familiar Cdike statements* 

• Complex formats handled by powerful syntax. 

• Input is checked and compiled as you 

View^ edit, or analyze your data. 

• Edit data directly in window, 

• Automatically check values, at your option* 

• File can be larger than RAM. 

Multiple uses; 

• Modify Finder Info and Hie paraincters* 

• Also edit data in application heaps, 

memory handles, and parameter RAM* 

• View entire disk volume,?. 


Quadrivio General Edit 

ADVANTAGES 

✓ Quick insight into data structure contents. 

^ Easier than studying MPWs dumpfile output. 

Faster debugging with clear display of data. 

✓ Saves coding time with direct data editing. 


NEW 


On-line version $195 


Start using General Edit just 30 minutes from now. 
Visit our web site* See, Learn, and Download. 


http://www.quadrivio.com 


Quadrivio Corporation info@quodrivio.com 
1563 Solano Avenue #360 Berkeley, CA 94707 (510)524-3246 
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WEBTECHTM 


hy Paola Aliverli 
Contributing Editor Tantek ^elik 


Introduction to Cascading Style Sheets 


HTML authoring has Just 
gotten easier: style sheets 
land on the Web 


HiSI'ORY 

Cascading Style Sheets have been 
sporadically seen on the web for a 
while, ll isn't until recently, with the 
latest versions of Microsoft Internet 
Explorer and Netscape Navigator, that 
they can be more widely appreciated. 
Style sheets on the Web work pretty 
much like style sheets in a word 
processor, or in a desktop publishing 
application. You can define a style called 
‘note' with blue text, enclosed in a 
border, with 24pt type seL If you need 
to make visual changes at a later date, 
all you need to do is change the defined 
style, without going through all the text 
in a page, or all the pages. CSS allows 
you to establish a set of rule.s to apply 
tliroughout the document, or, in our 
case, a site. Just like word-processing 
style sheets, Cascading Style Sheets on 
the Web help in a more consistent and 
time-saving preparation of your 
documents, and in styling and 
formatting of your documents. 

The W3 Consortium has so far come 
up with the first list of specifications 
(CSSIJ, and Ls w<trking on the second 
series of specs. Both Netscape 4.0 and 
Internet Explorer ^.0 support most of the 
CSSl specs. Authoring tools are 


currently on the market to help you with CSS (Macromedia 
Dreamweaver, and Cascade, for example). You can find up- 
to-date information about the current CSS standards on the 
Web Consortium web site, at: <http://www.w3.org/Styl£/CSS/> . 

KEML was designed for stRicture, not for style and 
foimaUing. That’s why solutions like frames, and tables came 
along. The problem is that both of those solutions are neither 
straightforward nor consistent. Frames cause problems with 
b(X)kmarks, and tables bloat code and pmmote inflexible formats. 

Tables and frames will not disappear from everyday use, but 
style sheets will make your life much easier. If you are a web 
author, there will no longer be a need for tables hacks, spacer 
GIFs, or text-based GIFs. Style shccLs allow for easy maintenance 
of your site, easier design, and improved control over the page 
layout. They help build scalable sites, uniform sites with a 
consisieni look among browsers and platforms. If you are a web 
user, surfer, or cybernaut, you will like style sheets because the 
pages are smaller, your downloads faster, and the layout 'spiffier’. 
You will also like the browser scalability. 

CSS allows you to re-definc the lcK>k of HTML tags, add 
your t)wn styling to them, or create new Classes with new 
characteristics. 

For example, you c:an decide to have non-underlined links: 

<A STYLE="text-decoration: none*’ HXEF-ex ample s.html") non- 
underlined link</A> 

Or to have a blue <H1> tags: 

<H1 SmE="color: biue“?Hl biue</Hl> 

Or place a dotted border around a paragraph: 

<P ST¥LE='*border: dotted blue">parag3:aph with dotted 
bordGr</P> 

NT3; If you are among those who have not closed their <P> 
tags, it's time to start. Browsers behave much more predictably 
w'hen you close the tags properly! 


Faola Aliverti Is a wch designer at New Software, Inc. in l^alc Alto, CA. In her previous life, she was a software developer, 
and a translator. She can be reached at Paoia@Paola.com. 
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The bajtics 

How does style sheet code work? Let's start with some 
basic lerminology. In a style sheet okIc, tJiere is a selector 
and a declaration* 

Ajlink 1 text-decoration: none \ 

A: link is the selector* and 

[ text’decoration: none ] is the style declaration 

Ttic Style declaration has a prtjperty (in this case text- 
declaration’), and a value Cnone’). Tlie selector can lx? a tag, or 
a newly-defined class. More specifics on different selectors can 
be found in the CSSl recommendation: 

• <http://vwvw.w 3 ,org/pub/WWW/^^ 

Of course, even though the CSSl prf)}>crties are defined by 
the official spec, not all CSS~sawy browsers support all CSSl 
properties. For a list of what Is supported by Navigator and 
Explorer, you can jtx)k at: 

• <http://www*webreviewcom/guides/style/> 

• <http://www, pcwebopedia.com/CSS*htm> 

• <http://webreference.internet.com/htrol/css.html> 

They are not always up-to-date, but they are the be.si iVe 
found so far. 

Tliere are different ways to add style sheets to your HTML c(xle: 

• Rmbedding a Style Sheet 

• Linking to External Style Shc*et 

• Importing an External Style Sheet 

• Adding Styles Inline 

The above-mentioned examples (except the A:link 
example) are all inline styles. All you need to do is add the 
STYLE attribute to the tag you want to modify, and specify a 
properties and values. 

If you are kxrking at CSS not only for styling, but for efficient 
site management, you don't want to l>e rqjeating the style for 
each instance of each tag. Let's take a kxik at odier ways to 
implement style sheets... 


Embedded Style Sheets 

You can add your CSS code at the beginning of each HTML 
file you want to affect, by putting the following inside your 
HEAD (in your HTML <HEAD> silly!!!) 


cmbeddcd.html 

<HTHL> 

<HEAI» 

<TlTLE>Welcome to the fruit factory I</riTLE> 

(STYLE TYPE=**text/csG"> 

<l’ 

Hi Icolor : bluel 
A;link {text-decoration: none; 
color: green: 
forUsixe: larger: 
font weight: bold I 
P {border: dotted blue: 
text-align: centeri 

-> 

</STYLE> 

</lIEAD> 

<B0DY> 

<Hl>W€lconie</Hl> 

(P>You will find the latest and greatest news on <A 

HREF=“topo. html"' >this page</A> I 

</P> 

</B0DY> 

</HTHL> 

Remember to hide the con tent of your ^yk sheets from the old browsers with the 
HTMI, comment rag, as older browsers will ignore the <STYIJi> and <VSTYLE> lags, 
hut not the text in between. 



ilatioiifititobase ibr 

iroduct deratooersr 


relational^atabase functionality thi^ 
artifand a leg? Introducing 
dtF/SQT>£^l|^ 4 [^^ oroven, truly relational. 
Why now that SQL 

, and let dCRfSOL handle" 

fur 1 


m handling ♦ automatic locks 

♦ advanced R4 redbv^ 

wilA full tt^h6s^)9lliMji^m|^^^KSv^ords, acc^». ^ 
r^ls, encry g g ^ 

and server versions avSi^ble ^ que^^lmu^Qi^ ' - 
4nd load balancing ♦ smalhfli^inory footprint 

♦ C/C++ interface, ODBC diwBt EOF-Adapter, 
HyperCard, Supercard, and other interfaces 

& cross-protochr 

♦ Mac pos ♦ Windi ^s3.x 

♦ Windows 95/NT ♦ OsTT^TMJfmM 

♦ several UNIX f1av<^2Joeiif(!l^ Linux ♦ TCP/IP 
"^♦lP?t-A4i«T»I0S’'«'1^1cTalk ♦ Named Pipes 

GreaAi&Aitig terms 

♦ Use for free during development 
♦ free shipping license for non¬ 
commercial u.<se ♦ low rales for 
commercial products 
♦ Special agreements for 
CD-ROM apps available! 


Go check our WEB site. 
http://www.slab.de 
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Notice l\vM different property/value pairs for the same 
selector should be sepanued by a seniicolun 

External Style Sheet 

This iS my favorite implenientaiiun of CSS, as it aDows you to 
style several files in yoor site, and update them by cltanginj' only 
one file. You c'an create separate external files for the different 
sections of your well site. A file oiled 'eggplant.css’ can define the 
look and feel of the pages in all the seaions or^eggplant.com' site. 


HI kolori blufil 
Allink (text"dec;or^5rInn: none; 
color: j^iceen; 
font-size: larger; 
font-weight: boldJ 
P [Harder: dotted blue: 
text align: center I 




In the T'ggplant.cuni’ site’s pages, I will have the following 
code in ific <HKAn> to link to the 'eggplanucss' style sheet: 

REL^stylesheet FOtHF'"eggplant,css" TYPE="texi:/css“> 


cxicmalJiUHl 

<HTHL> 

<a£AD> 

(TiTLE^Welcome to the friiir ractoryl<TlTLE> 

CLINK RHL^styieaheet HREF='*eggplHnt -css"* TYPE=" text /css"^ 

CBoon 

<Hl>Welcai»K>C/tll> 

Cp>You will find the latest and greatest news on CA 

HREF“*news .htntl”>thls pagcC/A>l 

C/P> 

</BODY> 

C/nTnL> 


Importing an ExternaJ Style Slieci 

Let’s say tliai Kggplant is p^Jrt^ermg with TofioQ). in a sii\v, of 
To[)o Mtatse dolls, and 1 need to add TopoQ>/s tniditionjil style !o 
my Hggpiaiil site, 1 am do this by adding to my previously- 
mcniioned eggphinr.css' file one line of a>dc: ©imp mi ttri(top>,eis> 


HI (color; blue] 

Allink (text'decoraLion: panel 
P (border; dotted blue] 

Simport url{topq.esa) 


iinponcss 


You on import as many style sheeLs as you like {but 
beware of possible conflias, as the next seaions explain,.,). 
There are already collections of style sheets available on the 
web <http://www.microsoft.com/gallefy/file^^^ and expect more 
in the future, Iniponing style sheets can come pretty hantly 
when you don’t feel like creating the files yourself. Of coun^, 
you should lx* aware not i>nly of the legal implications of taking 
someone clsc's work, and use it in your own site, but also of the 
siahility of the site you are linking lo. 

As far as I am tell. rlKHigh, ifs something you don't have tr> 
worry afxnjt, yet, Ixxause only one venvion of the common biowseis 
snppoits imported style slicets (Internet Explorer 4.0 for ilic Mar:). 


Order of importance 

As you probably already guessed from kx>king at the 
exam [lies above, you can mix and maicli any of the rnethocls of 
implementation of CSS. Wfiicb one is more hnpoitaoL^ And which 
one will prevail, in case two of tiiem conflic:f? Although many 


references attempt to explain (see comments about and 
CSS2 specs in the next ser:tion), the correa order of im(x>rtancc 
is tile following: 

1. inline Styles, 

2. Embedded, Linked, and Imfxjfted Style Sheets. 

3* User preferences, 

4, Bniwser’s deftniit settings. 


Now let’s move on to the next section to find out what 
prevails when styles conllicl. 

Cascading Abiuties, lNiii;Rn'ANi:E5 Confiicts 
As you probably already guessed from looking at the 
examples alxive, browsers need firm ailcv of cascading and 
inheritance for different style sheets, or implementations thereof, 
in order to avoid chaos. The specs of CSS 1 differ a bit from CSS2 
in thi.s matter According to my research, browsers have already 
started to supjxjrt CSS2 niles. 1 will skip the CSSl rules, and ju.si 
discuss the CSS2 cascade rules, which, apart fmm being the 
latest, also seem more logical Here is the first set of rules: 

L Follow specific declaration.s, or, if there aren't any, inherit values. 
2. Sort dcciaraiions by importance, 

5- Sort by specificity of sciecttjr, 

4. Finally, among .sclcdors f>f d^ual specificity, die latest onewias. 

As most of the current versions of CSS browsers do not 
support factor 2 (the important’ modifier), 1 will concentrate on 
the cascading declanitions and Inheritance. 

The first rule can be divided in two simple mle-s: 

1. Cascading takes prtx'etience over inhehtancc. 

2. Follow the order in which die styles appear, coasldedng the latest 
(closest to tlK^ text lo which it lefers) style the most imporUnU 

Let's take a kxik at vvhai ra.scatiing and inheritance mean. 

Cascading declarations and Inheritance 

inherit.html 

<HTML> 

(HEAD) 

<STYLE TYPE-^text/cEs") 

<1 

Ht icolar: blue] 

BODY (text dejjoration: none: 
color: navy I 

A:link [text decorat ton: underline; 

color: green I 
P t font-style: italic! 

</STYLE) 

<Tm.E>Welcotne to the veggie factory 1 </TTTLF.> 

</HEA0> 

<BQDY> 

<Hl>Welcoine</Hl> 

^F)You will find the latest and greatest news on <A 
HREE^" latest, btnil" >thi s page! < / A></P> 

</B0DY> 

</HTMT.> 

All the text witiiin iJie <BODY> tag should be navy, and not 
underlined. The <H1> tag is within the lx)dy tag. it will then 
appear not underlined, Tlie <H1> tag has its own declaration rule 
to follow, and it will appear as blue. 
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The text within <V> will he in italic, and il will inherit the 
color specified in FiODY, Ijecause it has no color declarations of 
iLs own. The link tag <A>, though, has its own aile, and will 
display in green, while inheriting the italic style of the <P> tag- 
How can you tell which prtjjx^rties inherit? A simple mlc nijglit 
be this: pure adtjmmeni properties inherit, fomutting properties 
don't. Lg.: a a>lor pio^xaty will inherit A positioning pro(>erty 
won’L One notable exception to this rule: backgRKind and lx)rder, 
which can be c onsidered adornment properties, do not inherit. 


OuK-'adIng declarations and order __ 

artkrhtml 

<HTML> 

<HEAD> 

<STYLE 

<!- 

B ( fpni fiiinily: courier: 

color: bluel 
B I font'faiDily: arial; 
color: yeliowl 

</STYLE> 

<TmK>CSS is funK/TirLE> 

</liEAl» 

<BODY> 

<E> 

Is this text yellow or blue? Aria! or Courier?! 

</B> 

</BODY> 

</HTWL> 


The text will appear yellow anal, because the sei:ond rule 
wins over die first rule. 


Conflicts 

What hapfK*ns if style sheets connict witli a standard fl'l'ML 
tag? Ttie style sheet niles take precedence. 


tonflirt.html 

<HTML> 

<HEAI» 

(STYLE TYPE-"tent7CSS“> 

<1- 

BODY \ font-fanaly: arial: 
colon yellow! 

</STYLE> 

<TITLE>CSS are fun!CTmE> 

</HKAD> 

(BODY 

Siylc fihfiets take precedence over ffTML ta^^s. This text is 
yellow arial. 

C/BODY> 

</HTML> 


PrimeBase™ 

Prime Power Online 



High-petfomumce Relational DBMS 

Now available for Rhapsody 


Open System: ODBC, SQh, I>AL Conipliani 
Sealable from 68K Mac to tBM RSftUtM) 

Proven Reliability (formerly PJNK SQL) with iiistulMions 
arounij the v/orld 

Cross-platform: Rhiipsi>tty, MneOS. Windows 9S/NT\ Sun 
Soturis. Ltjmx. 

C.'ompetilive Prices (10-user server for Apple Hardware or 
PC: wily $S20) 

Highly Flexible Web Cmmeetivily available 
EOF Adapter for OpeiiStcp and Rhapsody 
Single-user Run lime available 


Developer Keys 


SNAP Innovation GmbH 
Tel: +49 (40) 30636400 
Fax: +49 (40)30636333 
sales ® primobase. com 


Download Now! 

www.primebase.com 



dass.fituiJ 

<,HTML> 

<I1EAD> 

(STYT.R TYPE^*‘text/css"> 

<r- 

.hilite (background color: yellowl 
-> 

</STYLE) 

<TiTL£>[ligb1 ight vhat's important</TrTI.E> 

</llEAD> 

<B0DY> 

<Hl>HighUgbt vhat’s (SPAN 
CLASS^-hilite" )linpoi:tari t ( / SPAN)(/H 1) 

With Style sheets, you can (SPAN 

CiASS=”hiliLe">htghlight</SFAN> tlic Imporiant parts of your 
document, 

(/BODY) 

(/FTTML) 


The browsers seem to hehiive differently, not only 
depending on the versions, but on the platform, as well. The 
over-valid web authoring rule applies even to style sheets: test 
on all possiidc configuratioas before publishing online. 

The mexst accurate sources of information I have found on 
and offline about browsers support are: 

Web Designer's Guide to Style Sheets, by Steven Mulder, 
Hayden books. ISBN# 1-56830-306-8, 
<http://www.webreview.com/gui(les/style/>. 

Classes, Ids, Contextual Selectors 

If you need to style different tags in the same fasliion Ce,g.: 
highlighting anything with a yellow background), or the same tag 
In different ways Ce.g.: three different kinds of underlining, 
according to where the links apj^ear), you can define classes 
within your style sheet. 


Hilite is declafx?d as a ciaSvS selector by fireceding it with a 
period Tlie <SPAN> tag is essentially just a vehicle for 
applying a .style to a range of content, il lias no intrinsic effect of 
its own. The CLASS attribute inside the SPAN tag then binds it to 
the style declared for the indicated class. 

cla!B2.html 

<HT«I.> 

<HEAD> 

<ST¥LE nPE=*text/css"> 

<!- 

P,green Ibackground-color: green; 
color: redi 

P.yellow (background-color: yellow* 
color: green I 

P.orange I background color: orange: 
color: purple! 

P.red !background-color: red; 
color: blue I 
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P.purple (background color: purple; 
color: yellowl 

P.blue I background-color; blue; 
color: orange} 

</STYLE> 

</HEAD> 

<B0DY> 

<lil>My favorite colorH</Hl> 

<P CLASS^"green■■>In thifl Hue we will talk about the color 
green.</P><BR> 

<P CLASS="yenow">In this line we will talk about the color 
yellow.</P><BR> 

<P CLASS“‘‘orange'*>Tn this line we will talk about the color 
urange.</F><BR> 

<P CliASS-"redl^>In thin line we will talk about the color 
red.</P><BR> 

<P CLASS’"purple^lMn this line we will talk about the color 
purple.</P><BR> 

CP CLA£S=^blue">In this line we will talk about the color 
blue*</F><BR> 

<7B0DY> 


The cla^s2Jurnl ex^imple demonstmies bi^ specific class 
selectors. Only <F> tags with ihe respective classes will bind tt> 
the styles declared. Other tags with classes won't lie affected. 
You can also use HfML 3 ID aiiribuics instead of CLASSES to 
define a new style. In this case, the ID will work as a .selertor. 


<HEAD> 

(STYLE TYPE-'-tExt/css'b 
<[“ 

#bggrtxr (background color: green: 
color: red! 

> 

</STYL£> 

</HEAD> 

<BODY> 

<Hl>My favorite coiors</Hl> 

<P>In this lino we will talk about the (SPAN 
lD="bggrtxr“>color green.</SPANXBR) 

</H0DY> 


You am also have a sequence of tags for a selector, creating 

contextual selectors. In ihis case, the CSS rules will apply to 
tags which have the indicated parent-child reiationship, 


raiiicxi.html 

<irrML> 

<BEAD> 

(STYLE TYPE="text/GS£“> 

(I- 

HI I B [hflckground'color: yellow) 

(/SITLE) 

</il£AD> 

<R 0 DY> 

(H I >Moro(l> <B>highlighta ! </B></I></lll> 

<P>In this litie we will talk about the <I><B>contextual 
selectors.(/B></I><BR> 

</B0DY> 

(/HTML) 


In this c:ase, ‘aintexaial selectors’ is bold and italic, but is not 
highlighted Liecause it is nor contained widiifi the <H1>. 'Highlights!', 
on the Ollier iiand does appear with a yellow backgitiund.. 


STY1.E Sheet Properties 

Here is a review of the main properties and tlieir values. I 
recommend you look at the books or URLs listed at the bottom 
of the page, and test your pages liioroughly, to make sure that 
tile properties are properly supported across browsers. Be sure 
to check tile CSSl Recommendation and the latest CSS2 Working 


Draft ft>r the complete details on particular properties and values. 

Possible values are listed after the colon, separated by a 
vertical bar I ”, meaning 'or', or l)y a double vertical bar “ M", 
meaning and/or. 

Cofiimofi values 

Many style profxiTties take the similar values. Here is a 
summary of liie mo.st common value tyfx.‘.s and what they mean. 
In the list of properties, I will simply list <iengdi> when a 
property can be defined in inches, centimeters, etc. 

Length 

length is expressed in inches (in), centimeters (cm), 
millimeters (mm), points (pt), pica.s (pc), em (em), x-height (ex), 
or pixels (px). 

Percentage 

I>ercentagc Ls expressed in comparison to the .standard size or 
size of one's parent tag. 150% means that the font-size, for example, 
is one and a half Limes the size of the parent tag's font-size. 

Color 

Any of the pre-delmed .standard web colors. 

11 , 4 ) 

Appears in properties that can take from one to ftmr 
values. Tlicy indicate the top, right, liottom, and left 
values respectively for the property. E.g.: 

Margin: <lengtfi> I <percentage I auto (1,41 means that 
lire four values of margin can ix: listed as follows: 

<P> (margin: 20px lOpx 20px lOpxl 

Properties 

Fonts 

font-family; <family name>, I I <generic namo 
where <family> : helvetica larial I times I etc. and 
<generic> : .serif !.sans-serif I cursive I fantasy f 
monospace. 

font-size: <absoluie> I <relative> I <length> I 
<percenUige> 

where <ab.soliite>: xx-small I x-small I small t medium 

I large I x-large i xx-large 

and <relative>: smaller i larger 

font-style: normal I italic I oblique 

font-weight: extra-light I light I demi-light 1 medium 1 

normal 1 demi-lx)ld I \xM I extra-bold I toider I lighter 

I 100 I 200 I 300 1 400 I 500 I 600 I 700 I SOO I 900 

font-variant: nomial ) .small-caps 

text-n^nsform: capitalize I uppercase I lt>wercase I 

none 

text-decoration: none I underline 1 overline I line- 
through I blink 

Color and Background 

color; <color> 

backgroiuid-color: transparent [ <color> 
background-image. <url> I none 
background-repeat: repeat I repeat-x I repeat-y f no¬ 
repeat 
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background-attachment: .scroll I fixed 
background-position: <percentiige> I <lengili> I top I 
cenier I Ixjuom I left I right 

background by itself also takes any of ilie above values. 

Space and Layout 

word-spacing; normal I <lcngth> 
letter-spacing: normal I <length> 
line-height: nt>mtal I numlx^r I length I percentage 
text-align: left I right I center I justified 
text-indent: <length> I percentage 
verticabalign: baseline I sub I super I top I text-top I 
middle I bottom I fext-btjttom ! <percenLage> 
margin: <lengLli> I <percentage I auto 11 , 4 ) 

In lieu of the shorthand margin, you can also use the 
more specific: margin-top, margin-right, margin- 
bottom. margin-left. 

padding: <lenglli> I <iX'rceniage> ll, 4 ) 

In lieu of the shorthand padding, you can aLst) use the 
more specific: padding-top, padding-right, padding- 
bottom, padding-left. 

border-width: thin I medium I liiick 1 <iengih> (1,4) 

In lieu of the shorthand border-width, you can also use 
the more sfxcific: border-top-width, border-right- 
width, border-bottom-width, and border-left-width, 
border-color: <color> U,4l 

border-style: none I dotted I dashed I solid 1 double I 
groove I ridge 1 inset f outset 11,4] 
border: <b()rdcr'Widtli> 11 <border-style> I I <border- 
color> 

In lieu of ilxe shorthand border, you can alsfi use the 
more specific: border-top, border-right, border- 
bottom, and border left 

width; <length> 1 <percentage> I auto 
height: <lcngUt> 1 auto 
float: left I right I none 
clear: none I left I right I both 

^ j^itJohihg 

position: absolute I relative I sialic 
left: <iength> I <percentage> I auto 
top: <length> I <perc‘cnLagc> I auto 
width: <lengtli> I <percenTage> I aura 
height: <lengLli> I <i>ercentage> I auto 
overflow: none I clip 1 stToll 
/-index: auto I <integer> 
visibility; inherit I visible I hidden 

Classlflcatioii 

display: [)lock I inline I list-item I none 
white-space: normal I pre I nowrap 
list-style: <keyword> I I <position I I <url> 
where <keyword>: disc I circle I .square I decimal I 
lower-roman I upper-roman I lower-alpha I upper-alpha 
I none 


^ CAILINGALI 
CODE WARRIORS! 

Winmag the battk but hsiug the war...? 

Synergex^s plug-in to Metrowerks' CodeWarrior lets 
you control complex software projects from the 
comfort of your favorite IDEl 

mmSOLV pves Vers/on Manager™ 
for Madatosh® 

■ Monoge versions of any file type—even HTML! 

■ Check hies in ofvd out without leaving CodeWarrior 

■ Use the industry s top-rated multi-pkiflorm SCM tool 


Si' 



TO ORDER CALL- 800-366-3472 

WWW, sy nerqex . com 
pves- i nfo@synerqex .com 

2330 Gold Meodow Way - Gold River, CA 95670 

«5.SYNERGEX iiNTERSOLV 

fluirl CrrtrtfJlji Siitm.'** 

All trodbmdHci are the property of lliflir OMmen. 


<position>: inside 1 outside 
and <url>: <url> 1 none 


In lieu of the shorthmd iLst-style, you can also use dte more 
specific: list-style-typc, list -style image, and list-styk-positkm. 


Fun with Style Sheets 

Here are a few examples that will liopefully give you an idea 
of flow much fun you can have with style sheeLs. The examples 
ate sample crxle ttiai you can use, but they are not guaranteed to 
be a complete, scalable solutiQn.s for all l>rt)w.sCTS and platforms. 


RoUoyer effect_ __ 

rollover html 

<HEAD> 

(STYLE TYPE^-’text/css'’) 

(!- 

A:JLinl£ (color: Davy; 

texl dccoraTion: none* 
ront-fll7.e' ^iOpt: 
font'family: helvetica, ariall 
A:active (color; orati|el 
A:hover I font-weight: bold; 
color: redl 

-> 

</STYLE> 

<TlTLE>Rollover effect</TTTLE> 

<B0DY> 

This example will work for Intornet EKplorer 4.0 Ksc 
users:<BR> 

<A HREF=’'rollover.htBtr>mi.OVER EFFECT</A> 

</BQDY> 

</Hm> 
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UnforiuniilcJy, this example will work only with Internet 
Rxplorer 4,0 for the Mac. But considering how litiie it lakes to 
impiement it, why not add a little excitement just for your 
Internet Explorer Mac users? 


Navigation bar_ 

navigation.html 

cum> 

<HEAD> 

<TTTt.E>navigalc with CSS</T1TLE> 

<STYLE TYPE”"text/css"> 

A:link {color; blu^I 

A;visited {colorr navy} 

A; active {color: orange I 
A:hover [color; redi 

A.nav:Hnk (color; white! 

A,nav:visited [colon #3300FF| 

A*nav:active (color: yeHowj 
A.navthover [color; yellow! 

-bar [Hue-height: 150%; 

background color: #FFOOOO; 
font-weight I bold: 
font^fsroily: helvctlca) 

<ySTYLE) 

</HEA0> 

<B0DY> 

<CENTEH> 

<DTV CLASS-"bar”> 

CA aASS-*nav" HREF^*^hotiie-htaL''>home</A> 1 
<A CUSR“-nav* HREF-^abounhirar>about us</A> I 
U CLASS="nflv“ HREF"-prod,hLiil'‘>prodiiccs</A>| 

<A CLASS-^nav“ HREF=*^news.htiiil“>news</A) | 

</l>IV> 

</CENTER) 

C/RODY) 

(/HTML) 


This is a simple navij^aikm har, that lakes advantage of the 
<A> and <DIV> lags, and the and “bar" classes, 

‘bar' defines the ‘spine* of our bar. It scLs die font to use 
(lielvetica)j the weight (Lx)ld), the background color (some sort 
of red), and the line-height (150%), which gives the ixir' elTecL 
To set the line-height, you could also use a number (\ the 
browser will multiply tlxit numlx?r by the font-size sjiecilied), or 
a value, such as 'em* or 

‘nav* deciders die [x?havior of the different <A> tags. We can 
safely set die link color to white, because if the browser doesn't 
recognize CSS, it will nol display any of the values. 


Horizontal rule ___ 

hrbim! 

(HTML) 

(HEAD) 

(STYLE TYPE-’'te^Kr/cBfl“) 

*hr [background-Itoage: urKpIsnf'^g} T): 
width: 70%: 
line-height: 150%: 
tent align; center I 
</STYI.E> 

(TITLE>Nice horizontal rule</TlTLE> 

(/HEAD) 

(BODY)(CENTER) 

Da plane* da planeKBR) 

Da plane* da planeI<BR> 

(SPAM CLASS="ht"><BR></SPAN> 

<BR> 

Da plane, da plane!(BR> 

Da plane* da planeKBR) 

Da plane, da planeKBR) 

(/CENTERX/BODY) 

(/HTML) 

You can take a logo or a small image and use it as a 
l>at:kground image to create a different kind of horizontal rule. 


Chapter divider _ _ 

chapdiv.html 

<Hm> 

(BEAD) 

(STYI*E TYPE—text/css") 

.hr [width; 100%; 

border-top; thick iinlld red: 
color; red; 
text-align: left; 
font size: 24pt: 
font weight: bold: 
font-famfly; ar.ialJ 
(/STYLE) 

(TITLE>Chapter divider(/TTTl*E) 

(/HEAD) 

(BODY) 

(F)ThJa example will show you how to divide different 
seetionf: of your page:(/P) 

(DIV CLASS=’'hr“>Cotfipany</DIV> 

Here is where we talk about the company t 
(DIV CUSS'-’'hr">ProductE</DrV> 

Here is where we talk about the producta. 

<IUV CLASS="hc">News</DIV> 

Here la where we talk about the news. 

(/BODY) 

C/HTML) 


This divider is ideal to break out chapters or sections of your 
page, in a Ixxik-likc format familiar lo your user 


Shapes and colors _ 

cggpUnihtml 

(BTHT,) 

(HEAD) 

(TITLE)Coiipany' s logo(/TTTLE) 

(/HEAD) 

(BODY) 

(SPAN STYLE="C0LOR: green: POSITION: absolute: TOP: 5px: 

LEFT: IBOpx: font-weight: hold: font-size: iZpt: font-style: 
Ualjc’'>!<ySPAN>(BR> 

(SPAN STYLE-^"COLOR: greeii: POSITION: absolute; TOP: 20px: 

LEFT: 170px; font weight: bold; font size: 12pt; font-style: 
italic") n</SPAN><BR> 

(SPAN STYLE="C0L0Ei green; POSITION: absolute: TOP; 40px: 

LEFT: I70px: font-weight: bold; font-size: 32pt: font-style: 
italic">!</SPAN><BR) 

(SPAN STYLE-^*-COLOR: green; POSITION: absolute; TOP: 70px: 

LEFT: 105px’*><Jreeiv, Green, Green. Green,</SPAN><BR> 

(SPAN STYLE=“C0L0R; green: POSITION: absolute: TOP: SOpx; 

LEFT: 100px")GreenGreenGreenGreenGr eon ( / SPANXBR) 

(SPAN STYLE-^’COLOR: yellow; POSITION: abnoliite; TOP; ROpx; 
LEFT: 95px">Yeilow.yeIlow.Yellow. Yellow. </SPAN>(SR> 

(SPAN STYLE="C0LOR: yellow; POSITION; absolute; TOP: lOOpx: 
LEFT: 92px**>Yellow.Yellow. Yellow.Yellow. (/SPANXBR) 

(SPAN STyi.E“‘m.0R: orange; POSITION: abaDiute; TOP: llOpx; 
LEFT: 92 px" >0 range. O range * Orange. Orange. ( / SPANXBR) 

(SPAN ST¥LE="COL0R: orange: POSITION: abaoUite: TOP: I20px: 
LEFT: 95 px” >0range, Orange. Orange. Orange. < / SPANXBR) 

(SPAN STYLE=”C0L0R: red: POSITION: absolute: TOP; llOpx; 

LEfT: 95px">Red,Red.Red,Red,Red,Red.Red.(/SPANXBR) 

(SPAN STYT.E'^^COLOR: red: POSITION: absolute: TOP; I40px: 

LEFT: 100px”>Rt:!d.Red,Red.Red.Red.Red,Red.</SPANXBR) 

(SPAN STYLE="C0LQR: purple; POSITION: absolute: TOP: IbOpx: 
LEFT: 105px">Purple. Purple. Purple. Purple.(/SPAN)(BR> 

(SPAN STYLES”COLOR: purple; POSITION: absolute; TOP: I60px: 
LEFT: il0px”>PurpIe.Purple.Purple.Purple.(/SPANXBR) 

(SPAN STYLE=”C0L0H: blue; POSITION: absolute: TOP: 170px: 

LEFT: l20px”>Blue. Blue, Blue. Blue.(/SPANXBR) 

(SPAN STYLE="C0L0R; blue: POSiTlDN: absolute; TOP: IBOpx; 

LEFT: 12 5px" >B1 lie. Bl ue. Bl ue. Blue. (/SPANXBR) 

(/BODY) 

(/HTML) 


This example might give you ideas for a different kind of 
ASCII art! 


Positioning_ 

cxamplcs.html 

(HTML) 

(HEAD) 

(TITLE) Ititro to CSS</TITLE) 

(STYLE TyPE=-text/cas"> 
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A:1tnk (color: blueJ 
A:hover 'Color: cyfiOl 
</STYLE) 

</HEAD> 

<B0DY> 

<CliNTKK> 

<SPAN STYT.R”"co1or: black j position: absolute: top: 20px: 
lofl : fontweij^ht: bold: font-size: 48pi: ftmi Tan My: 

arlal. helvetica*'>Introdtiction toC/SHAN) 

<SPAH STYLE='‘color: cyan: position: absolute; top; 50px; 
left: 200px; font weight: bold: font size: 4&pt: font-family: 
arial, hBlvetlca“)CflSf:arfIng^/SPAN) 

<SPAN STYLK”''ro1or: navy; position: absolute: top: /bpx; 
left: I'^Opx; font-weight: bold; font -Size: 48pt: foul family: 
arial » helvetlca''>Style</SPAN> 

<SPAN STYLE“‘**color: blue: pasitioit: absolute; top; lOOpx; 
left: 250px: font weight: bold: font size: A8pt: font - family: 
arial. h€lvetica'‘>Slicets</SPAN> 

<SPAN STYLE^"t'u1or: blue: position: absolute; top; 4px: left: 
ilOpx; font size: ?.Rpr; font family: times. helveticii''><A 
|]REF“'*hl I. p: //WWW. mar tech. coaj“)KacTech. June L99K</A)</S]^AN) 
</CKNTRR> 

(SPAN STYLE”“position: absolute: top: ISOpx: left: 'iOpx^> 
<H2>The basics</II2> 

<A HR£F="embedded.himl">Cfflbodded</A)<BR> 

<A HR£F*^''exiernul .himl‘‘>saiiiple</A> of <A 
ilKEP“"eggplant .rss")eKtfirnai file^/AXBR^ 

<A HRKF'""inherlt.htnil">inherit3nce</A><BR> 

<A HRRF-"ord 0 r.html'‘>order</A><BR></SPAN> 

<A HREF=‘‘c<infUct.html“>Cartflict</A><BR> 

(A HREF““class.html”)class. example 
<A HREF“^“ciass2.hlHil''>cla«s. example 2</A><BR> 

<A HREF-“id.lUMr>Th</A><RR) 

<A lllfEF^^caniext .hfml"^contextual 

(SPAN STYT^F.™’*position; absolute: top; ISOpx; left: 2!i0px“> 
<H2>Fun with Style Sheets</H2> 

<A HREF=“ro:iover.htmr>roliover</A><HK) 

(A HKEF"-“ navi gat ion.html ">naviga l itJii</A><BR></SPAN> 

<A HREF-*hr.html*')hotizonlol riile(/A><BR> 

<A liRKF^^chapdiv.hl ml “>rhnprer divider</A><BR> 

<A HREF~“eggplant .html*')eggplaiit(/AXBR) 

<A TfREF”"eggplant .htnil“>eggplant</A><BR> 

<7 BODY) 

</HTHl> 

Amazini? wfiat you can accomplish with positioning, isn t ir? 

Reitrences 

niore arc many HTML authoring lxx>ks that have sections 
about CSS, but I would stiggest looking at more .spccillc guides. 
Here is a list of tiiy favorite reference's: 

Books 

• *‘Web Desigrter'.s Ciuide io Style Shcx:Ls"; by Steven Muldeg 
Hayden Bcx)ks - < httD7/www.havdenxQm/inTemetistvle > 

• “Qiscading Style SheeLs - Designing for the Web", by Hak<m 
Wiuni Lie and Bert Ro.s, Addison Weslc'y. 

URLs 

• http://wvw.w3,org/pub/WWW/Styie/ 

• http://webrefefence.internet.com/hlml/css.html 

• http://www.webreview.com/gujde5/sfyle/ 

• http://www.microsoft.com/lruetype/cs5/gallery/entrance.htm 

• http://www.pcwebopedia.com/CSS.htm 

A Few Sites that use CSS 

• http://www.espnet.sportszone.com/editors/atlanta96/ 

• http://www.cnet.com 

• http://ww.eastaxxom/eastaK/stylefun.html 

• http://wviAjV.w3.org/pub/WWW/Style/css/msie/instght.htm 
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Build great applications... Better 

f Great iGood’nuf) Cheflpef 

Rsterr 

Too s nus 


LtBRARIES + FRAMEWORK 


Make cool apps while others are slill reading I heir manuals. 
Professionally polished. Wickedly fast. Delightfully efficient. 

"'...f/Tc routines are njore compact and faster 
than mwthhtgyou might wrfk\..[!very chtnenl 
of foots Plus is Lisefut^.^ a bargain cnivparerl 
with coding these routmes yoiirsett] 




C_0K ) 


OK 


You build the interface. 

Tools Plus provides the infrastructure. 

It makes all your pieces work together as an applicaiiorv 
With only a few hundred routines, Tools Plus thins your code 
by tens of thousands of lines. You see results sooner. 
Changes are a snap. 

M// />j alf ifs an mi:redibiy rich t:oik’irtifm of fooh,,. 
if you are interested in developing applications ' . 
that have 'quality^ written all over them, then 

. . Tools Plus IS loryuu." MacTech MACAZINF 

Yes, Tools Plus has it! 

• Create any elemerti ushrj* a sinji^le routine 

• Everything works as soon nS you i rctale il 

• Automates all standard CilJl etemenK 

• Windows, Tool bar and floaling paieltes 

• Buttons (all kinds, flat and ID) 

• Scroll bar^ (speetl ctinimt live straifingl 

• World-dass custom cunirols 

• Fields (w/stroll bars, filters, auto-pfliling) 

• Picture buttons best any\vhe?rG) 

• List boxes 

• CDEF and LDEF automation 

• Cursors (colur. animated aiito-change) 

• Menus {pulMowu, hlerarLbical, |!Op-iu[jj 

• Edii menu (yi>clo/ii?clo. automaiic editing) 

• Panels (ID, group boxes, lines, ptines) 

• 3D titles < raised or inset] 

• Extended multi-monitor and color support 

• Clipboard aulomation 

• Dynamic alerts (w resources rer]uired.F 

• Eveiil processing automation 

• Over SOttK o( ciistom fonts, icons, cursors, 
and other useful resources 


Pius thousands more exciting features and servicesl 
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Underline 


-Results:— 
1^ Radical 
□ Slick 
^ Rauin* 


■ C - , . 
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I 2 3 ; 4 5 & 7 

Inset Panel Raised Panel 


1331^ 

SUDI 


uperCDEFs' $89 value 

^prafessiDnally designed and era fled cnnlrntE 
✓dozens of 30 & flat buttons, labs, sliders 

Tools Plus for 

SyiTHiittc iTH INK) C/C++ mt() $ 149 

tUiNK P,i5Cjii SH'J 

TniNkr/f++S,TMtNliPAWa3 ii-n 

CodLWami+ limoK fififtO 
CrKteWarrkf CkikJ W* 

iWt .tcrt'pr VISA and Amyjt wnb- Add *1U lor iti jppki^.l 
TjU ftjr Arjidcfliic 


Waliw^s Idpp Suflwar^ 

2441 Ro-id W«l, Sav TpOlI, 

CMfcvftle, Onlanqi Cananti L6<l WWi 


Orders and Enquiries: 


Fhoiw: (4t^2l9-Sbl8 
rax: (W5HM7.10.18 

W.itr rr dj^SWtJ^'iial.rom 
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Available at web silt 

iit tp;//www. inlcrfog.com/--watcredg 
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by Richard Wesley 


Version Control and the Single Developer 


Hrnv Version Cxtntrol Can 
Make Your Life Safer and 
More Productive 


We Don’t Need No 
S' liNKiNG Version Control! 

St> here' yuu are, writing tik: neM great 
appiicatiuj) in yuur l>ascinenC lVlayi>e y(»ii 
arc by yuur.sclf, or iiiaybt^ like me you only 
have one olhcr developer to wa>rry nl>oul. 
Why siiouid you Ijolher witli versirMi 
conuol soli ware/ Alter all, you arc 
probably use to being able to niodify 
anything you want ai any thm, and the 
wotsT you niigiii have to do is yell aerojis 
file nx)ni *'l>ave - Tin going to work on die 
niter code ncjw, so don’t touch it until Tm 
dond" Why give U]> all this I'reedoni? 

Tills article will attempi to convince 
yoii tliar there are many practical reasons 
to use vei^ttin control even if you art* just 
by yourself. Here at Klectiic Fish, we 
cievekjp njauy sniall projects for clienis 
tIuU require only tme develu[K*r, vei we 
use version conUol for every project. Tins 
article is intended to introduce the basic 
cont:efits of version control and discuss 
what sfieciPic pioliiems it cun solve fur 
you, the .small developer. 

In this article, I will present all tlie 
basic version control conmiands and 
discuss tile prubleiiLS tliat tliey solve. I will 
l>e using the CodeWariiur Version Contixil 
menu temiinoiogy^ as it provides a simple 
interface to alistmcl versiiin tXHirrol 


system, and i will using examples from various source control 
systems, including Projector, CVS, Perforce and PVCS, all of 
which have GxleWarrior VCS plugins. 

Basic Concepts 

Version control systems are a means of tracking various 
vcTsiorLS of a set of JOes. Most of them also include facilities for 
tracking groups of files (although PVCS dtK\s not). All of them deal 
with the issue of interaclion lietween developers, altliough there 
are many different ways of doing this. All .systems have some 
notion of a datalxise that slore.s the varitjus versions of a file. 

There is a general sequence of evenls that happens when 
you use most version control systems. 

• First of all, a database must l>e set up somewhere. This may 
lie on a local file system (Prt)jcctor, PVCS) or on a TCP file 
server (CVS, Perforce) or somewhere else. Generally, all you 
need to know is where it is. 'fhis is the Connect operation. 

• Now that you have a tkiiaha.se, you need to be able to add 
files to it. This inckides all the files you have now and any 
new files you may wish to add. Ihis is the Add operation. 

• Once you have files in the datalvase, you need to be able to 
modify them. Jiome systems require you to tell the database 
you are working on them, but some (like CWS) allow you to 
just modify die files at will and submit all the changes when 
you are done. Tills is the Checkout operation. 

• If you change your mind, you may want to revert to the last 
state of the file. This is the Undo Checkout command. 

• Once you have made your changes and tested diein, you 
need to put them back in the database for safekeeping and 
so that others can see them. Generally, this involves giving 
the dataIxLse not only wiicrt* the new version is, i>ut alsi> a 
description of what you did. This is the Checkin operation. 

• After all the changes have l>een made and the software is 
ready, it is coinnion practice to label all the file versions that 
go into the slipping version so that they can lx^ referred to 
later. This Is the Label operation. 


Richard Wesky <hawktlsh@elt;ttricfisli.Luin> is a Stiftwiire Development Consultant and CoPrestdeni of Electric Fish, Inc. He 
has l>een deveioptug Macintosh software since 19H4 and is tlie author of the C'WProjecror and CWCVS version control plugins 
for CodeWaiTior 
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• At some point, you may wish to go back and look at older 
versions of a file or groups of files, or you may simply wish 
to get the latest versions of all the files in the project after 
a coworker has made some changes. This is the purpose of 
the Get operation, 

• After a while, a file may become obsolete or need renaming. 
These are tlie Rename and Delete operations, 

• Version control systems can generate various useful reports 
about files, 'these are the Difference, History, Properties and 
Status operations, 

• Tliere are a few more operations piovided for in the Code Warrior 
IDE, but we will not be dealing with them. Included in this list 
are Variables, Comment, Rollback, Destroy and Purge, 

Version CoNTRt)L SoLtriioNS 

These are the basics of verskm control. Here is how it can 
make your life more pleasant and productive. To fticilitate the 
discussions, each operation will be introduced by a particular 
problem that it solves. 1 suspect that some of these problems 
frustrate you on a regular basis. 

Why can't 1 mount my hard drive?!! 

One of die most imporlanl tilings dial version control can do 
for you Ls automatically make copies of your work on a drive or 
machine other than your development drive. Your development 
drive lakes a lot of al>u.sc, and having a copy of your work on 
another disk increases your safety imrgin. Not that you should 
use this in place of a regular backup strategy, but it can help. 

You could dt) Uiis tlic old fashioned way by making copies 
of your source tree, but most version control systems make this a 
lot easier and less confusing. We have all mn into the old “Which 
c:<)py <if the source tree is this?" With a version (xintrol system, you 
have all versions of your files in one place and you can not only 
determine which source tree you have, but you can obtain any 
s(>urc:e tree you ever had. 

Tlie most importani source tree is, of course, the latest 
version. With version control you (and anyone you may be 
working wifhj never has to iisk “Where is the latest version of the 
code?” This is die purpose of die Connect operation — to connea 
you to a separate copy of your work that is well organized. 

Am I using this file? 

We have all been in the situation of wondering whetlier a file 
is actually being used, dhe problem is that once we figure it out 
(usually by moving it and seeing if the pnijecL will still build!), we 
liave only our memory to rely on when wc ask die question again 
two weeks later Ihis is the purpose of the Add operation — it 
allows us to mark a file as being used when we first create it. 

Conversely, you may deleniiine that a file is no longer 
needed in a project for some reason. This is the purpose of the 
Delete operation. Delete does not remove old copies of the file 
from the database, it simply says that diis file will not be needed 
in future versions of the project. All the old versions are still 
there, but you need to perform some special request to get ir 
back. Most systems will even allow you to resurrect files if you 
later decide you need diem again. 


/!/ '/OUA 
PJA. 0 '/ /) TO '"PJ/AF"? 



• Cr<?ate floating network 
- Tie Jicen.^ie to host name 

• Tie license to ;is^r name 

• Tie to hast ID 

• Allow as many users as desired 

•Have unlimited number of licenses im a network 
" Add licenses on the fly ^ 

• Automatically un Ucen.se if application i.s mover I or copied 

• Generate expiring licenses for "hill stiength" demos 

• Works on Yellow Box for Windows as well as MACH/Rhapsody 

• Come.s with sample app and license key generator 

o I 1: r & 

www.stone.com/Licenser/ info@stoiie.coni (SO.S) 34.S-4S0f| 



I didn't mean t(> change that file! 

One of ihe Ihings ihat 1 parlicularly hale about every 
development envirc:>nment 1 have ever worked with on desktop 
compitters is that the library header files provided by the compiler 
vendor an? not It eked. All it takes is for one of my cals to w'alk 
across rhe keyboard and there goes Menu.h or sometiiing. 

At least 1 have the vendor’.s originals .safely burned onto a 
CD somewhere. More likely thougli, I will open a project tile ro 
look at something, gel lost in the mess of windows f usually have 
open at one rime, and blow away something important. It really 
helps ro have to delilTerufely say "T warn ro modify this file” 
before you can do sti. 

Tliis is the purpo,se of rhe Ghackout openriion — it allows yr^u 
to lx* deliberate about what changes you make. Some systems (like 
Projector) even allow you to enter a comment deserihing what you 
l>lan to do when you tlo a Checkout wliich can lx* very useful when 
it comes riine to check in all the files for a major change. 

Some readers may be wondering why we liaven'L discussed 
the other common meaning of Checkout, namdy that the file is 
marked so that no one else can mexiify it until the develo|X!r 
doing rhe Checkout releases it. Projector work.s rhts bur 
many other version coniroi systems do not, CVS just merges your 
changes hack into the database version, which is why in CWCVS 
i made the Checkout operation simply unlf>f’k the file - to 
preserve ihis delilxtrale deciskm to modify a Ole in a sysleni that 
nominally allows you to modify anything at any time. 
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What was 1 thinking? 

Of cniirst^, somefimes even with ihe lx:st t>f inLenLions wc 
(letride U) ck> itie wrtmg ihing and wish we could go back. This 
is die puipose of the Undo Checkout opemrion “ to gives you a 
higher level of unclo relatetl to the conceptual changes you were 
making to the file. Even if you were to use file leaking and 
unlocking to lie delibemte about your modilications, you w'ouid 
stdl have to go find you la.st copy of the sottrt e tree if you decide 
ihat you liave made a iniMake. With version control this is a 
simple problctii to solve. 

Have 1 backed up the changes to this file? 

If you are working with copies of your source tree, there Ls 
alw^ays these Issues of ■‘When do 1 make a copy of the tree?" and 
“Where do I save it?" ancl "What do I call And even if you solve 
diesc probienis somehow, you then come hack the follow'ing 
week and wT)nder ^'Now when did 1 bre^ak that dialog box?" 

'fhis is the purpo.se of the Checkin cromtnand - to mark w^hen 
conceptual irhanges have lK"en made to a file by commenting 
them and backing them up. When you chec'k a file In to a versiem 
conirol .system, you are making a copy of die current state of a 
file that you can a^fer htek to later. Most version control systems 
allow you to descTibe the changes that were made (some, like 
CVS, even retiuire ycRi to do so) whicli can be very useful for 
answering the dialog box cjuesiitm above. 

Some systcjiis (like CiVS and Perforce) even allow you to check 
in groups of files all at once. U you liave finished making chinge.s 
to nve files that all solve the sjime problem or implement the same 
feature, tiiis can l>e ver)' handy. Tlie CcxleWaiTior term for this is 
Recursive Checkin, meaning that all checked out tiles found 
reaiisively in the project source aa^ checked in together. Perfonce 
even guarantees that this is done mmiiadfy {\\vdi is all or nothing.) 
For sysLctiis iluit do not liave this o|ierjiion (like Projector anti 
PVeS), CodeWamor hel]i.s ycxi to fake it by sc^iming ail the changed 
files in the IDH, chexxsing Checkin and then allowing you to indic:ite 
iliai die Checkin a)mmem sliould Ix^ the same for all of the files. 

Where is the source tree for ESeta 1? 

So you’a* in liie IxUi cycle and you're up to Beta 3 or 
.something and a usei' who still liits Beta 1 finils a nasty hug that you 
ain't reprcxiuce in the late.st version, 'Ibis means that you want lo 
find the source ttxx you .siived with Beta ! to hel|> track down the 
problem. What did you citll it? Whem did you put it? Did you delete 
it when Beta 2 came out? 'this is die purptxse of the Label commanii 
— to allow ytm to col lee :i flic versions into lunciional gioufxs. 

Tite most common gniup is all the files currently in the 
project, and CodeWarrior's term for naming this groups is 
Recursive Label, meaning ihai all files found ret.ursively in the 
project source will lx collected togetlicr into a group. This is 
liow' you would find the Beta I source ccxle you need. Moreover, 
since the database only .stores changes, you probably w^oukln't 
ncxxl to throw oui Beta 1 to make r(K)m for Beta 2! 

It is also u.sefu! at times to label a few file versions that are 
related liefore you go and rewrite a suksystem. Suppose you 
change the way you implemeat your UK)lbar, and you would tike 
to lx alrte to refer back to die old toolbar implementation. You 


could collect all die file versions in the old impiementadoo 
together into a group for later reference. I'hen if you ever wanted 
to go hack and look at that implementation, you could refer to 
them as a group without distufixing the rest of your code. 

How did I do that? 

Have you ever wished you could go I nick and kx>k at an older 
version of a file? Mayixf you are having second thouglits alxxut part 
of how you solved a problem, or maybe a file jiLst got thrown out 
by accident. This is the purpose of the Get ofXTaUon — to retrieve 
versions of files from die dataliase. The most common version you 
might wLsh to retneve Ls the latest version, but you can Get any 
version of a file that has Ixen chec'ked in to die diuihasc. If you 
art.^ working with other developers, the Get o[XTation is also used 
to retrieve your ct>worker's latest changes to a file. 

From time to time, yoti just want lo gel a copy of 
everything in the database as il currently stands. The 
CodeWarrior term for this is Recursive Get, meaning that all files 
found recursively in the project source are retrieved. This can 
be very handy for tjuickly moving your workspace onto another 
machine or drive, it is also lujw yt>u retrieve saved groups of 
files created with the Label operation. 

When did I do that? 

Bugs don’t always show u[i right away. Tiyang to determine 
when you intrcxlucetl a change and what you changeci c:an be very 
tiifficiilt if you are using copies tif your source tree. Often, the 
actual change you are Ux>king for is no longer around, or if it is, 
you have no w^ay of tracking it dow n other than a vague memory 
of wdiich week you think you nuule the change. Tliis is the 
purfxxst‘ of tlic History operation - to pit jvide a list of change 
comments and dates in the order that diey happened. From such 
a list you am usually easily determine when you made a particular 
change and gn right in the version of tlic file tliat you need. 

W hat did I change? 

We [rave all used file comparison utilities to try to 
detenume what innocuous looking change caused that horrid 
problem. I bis is the purpo.se of the Difference operation — to 
allow' you to easily compare various versions of a file. One veiy 
common variation on this is to compare y()ur working version 
with the last version in the database. Using .source trees, you 
w<)ukl have to find the correci older version and run a file- 
(Ompare utility, but since most version control systems store 
actually store the dilTerences between files (called “deltas"), 
lei ling you whiit ha,s changed is .second nature to tliern. 
Moreover, Ixcause the files are all in once filacc, il is very easy 
lo just jioim to a pair of revisions and get an answer. 

Choosing a System 

Now tiiat I have (hopefully) convinced you that version 
control is a good idea, it is time to move on to deciding what 
system you shoiikl use. There are a number of considerations 
you sliould Ixar in mind while making this decision, including 
price, features, ease of use, supj-Kxrt, serv'er and plattbrm. 
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MPW Projector 

Projeaor is great. It is stable, fully feaaired, free, widely 
available supported by Apple and easy to set up. Its biggest 
liability is that it is a Macintosh only product, wliich is only a 
problem if you are doing cross-plarfomi work and can't do all 
your development on a Macintosh. Another small problem is that 
tiic Difference oj)cration Ls irnpleincntcd via MPW scripts instead 
of by a specific Projector command. 

Ihere are various levels of ease of use. You can use Projector 
from Ml’W via c(}inmand line directives and scripts; you can use 
ToolSetverASourceServer to script it from inside CodeWarrior and 
other loolServer friendly applications; you can use the PiojectDrag 
applets (on the Developer CDs) to manipulate flies in the Finder; 
or you can Uuse our sluircware CWPn>jector plugin/SourceServoT 
combination in CodeWarrior and talk to it through die CY)deWarrior 
veS menu. There is also another shareware C<ideWarrior plugin 
called ProjectorVeS availal)!e from <http://www.joyspotxom>. 

Projector is a file-based system, which means that the 
databases are just files on a niounted volume {usually a server). 
Tills means dial there is no special hardware (e.g. a POSIX 
server) to set up and backup i.s as easy as backing up any other 
drive. You can also work off-line with Projector and just check in 
any files that you made writcable when you get bac:k on-line. 

GNil Concurrent Version System 

CVS is a widely used l*OSlX based version t:ontn)l system. In 
the past year, two Macintosh clients have been written and under 
the terms of the GNU licease, both are in the public domain (read 
Tree"). CVS is unsupptiried, but ihea^ are many on-line resources 
for getting assistance, including die <info-Q/s@gnu.or9> mailing list, 
the comp.sofEware.config-mgmt newsgroup, and the Cyclic web 
site <http://www,cyclic.com>. You can also grjib the source and do 
your own diing if you like — as hir as I know tlieie is no Ml^W 
tool for CVS. 

CVS is very different from Projector. For starters, it uses a 
copy-inodify-iiicrgc paradigm, whicli means that you enn modify 
any file at any time and then submit all your change.s to l:>e 
merged back into the main database when you are ready. CVS is 
also TCP-based, wliich means that you must have a POSfX 
machine with a evs daemon lunning in oitler to use it. Tliis has 
advantages - CVS is also kerberized, wliich means that you can 
use die MIT Kerberos protcxiols to talk to a sender securely over 
the internet, which can Ixi very useful if you are working remotely 
for a client. CVS is also available on just about any platform you 
can think of, which makes it a gcxxl choice for cmss-platform 
devdopmenL On die down side, setting it up can lie a hear for 
Macintosh users and doing repository backups requires working 
with some sort of POSTX hat:kyp system. It has been suggested 
that one could use an AppleShare client but wc have not tried it. 

Ease of use comes down to choosing a client. I use the 
MacCVS 3 0 client developed last year at Strata (available at the 
Cyclic site) and our shareware CodeWurrior plugin (hai tiilks to 
it. You can also interact directly with MacCVS via various menu 
options and command-line windows. MacCVS is based on the 
GNU sourt.e so it will be able to track changes easily. 



"If you're a developer^ you've got to get TestTrack. 
Your bugs will bate you for it!" Coal Tool of the Doy 


Discover the tool today's top software developers ore using to improve the 
quality of their Macintosh and Windows applications— TestTrock. 


• Track bugs, feature requests, problems, 
customer infomiQlitm, nod more. 

• Hew! E fuail rraHfiratkjrK — SMtP and MAPI. 

• New! Import bugs via e-mail autumolicQlly. 

• Prorftice concise repofls- 

• Multiple users, full security-link engineers, 
testers, managers, even tech writers. 

• New! Improved help ttesk support. 

■ New! Deferred defect numbering, external 
ottuchment storage, customer bug hislories, 
end much, mudi, more. 

■ Aulomoticnlly route hugs to team memhecs. 

• Truck the history of each bug. 

• Save time and improve teth support by 
giving Solo Bug, TesiTrodt's stnnd-alone bug 
reporter, to your customers. 


Only $169! 2+for $149 eoch! 
To order coll 888-683<6456 
or513-683-64S6 



Download our demo today! 
http:// www.$eapine.(om 


SDles@seapine.tom 

http://www.seapine.tom 



The other client 1 know of is Mact;v.SClient- 1.3-3 written last 
year at FontWorks (also available at the Cyclic site). This is a 
threaded Power?IanL application Lliat knows the ews p.st‘rver 
protocols but as far as I can tell, it only works with pseiver and 
does not support Kerberos. Because it is not based on the GNU 
di.stribution, it i.s not dear how it will track future changes. On 
the Ollier liand, it has a fabulous GUT, seems very easy to use (no 
mean feat for CVS!) and looks really sliarji. At the moment^ the 
two client authors and 1 are all talking vaguely about integrating 
liic Strata back end, the FontWorks front end and Ltic Electric Fish 
plugin, but this will probably not happen any time soon. 

Perforce 

Perforce is a nice commercial system from Perforce Inc. 
(wwTv.perforce.com) that nrns on a wide variety of platforms. 
The demo version of I he system is a two-workspace license, 
which means that it is free for single developers. Because it is a 
commercial product, it is supported and updated, but unless you 
pay for some son of license, you will nol be able i.o gel much 
help from them (fair enough). Their documentation is all on line 
at the site and also comes with the demo package. 

For diems, Ferfort:e has both an MPW rcx>l (p4) and a 
CodeWarrior plugin (CWPerfoice). Tlie p4 tool Ls a bit awkward to 
use as it launches a local client application, but the plugin (which 1 
wrote) can perform mast basic operations from within OxleWarrior. 
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You will fiUll need U> use liic Ml^W UkA for more complex operatioas. 

Perforce is a TCP-based system and requires a non-Mac 
server ir has no security features that 1 am aware of, so il is only 
good for in-house developincnl. Wc used tlie Linux version to 
develop the plugin with no problems* 

VOODOO 

Aside from the Perforce free demo, VOODOO (Versions Of 
Outdated Documents Organized Orthogonally) from Uni 
software (www.unisofi.etj.ai) is currently the cheapest 
($229/seat) commercial system available for the Macintosh. Like 
Projector, it is a Macintosh only system and stores databases 
using the file system. VOODOO runs as a standalone application 
and Ls integrated witli both CodeWarrior and BBEdit. 

VOODOO'S onhogonal organization scheme was described 
in the December 1996 MacTech article “Keeping Things Straight, 
Orthogonally” by Christoph Reichenberger. There is a free demo 
that you can download from the web if you would like to 
investigate it further. 

Other systems 

1 know of two other version control sysStems with Macintosh 
clients, both commercial. Pricing on them is high (over 
$400/scat) but they may do exactly what you need. 

Metrowerks sells Visual SourceSafe, which is (of course) 
well integrated into the CodeWarrior environment and Ls l>ased 
on Microsoft's Visual SourceSafe product. SourceSafe can be used 
in a cross-platfomi environment with Windows developers using 
Microsoft Visual SourceSafe . 


PVeS Version Manager from Intersov is another widely used 
crass-platform system for tracking individual files. Syneigex ported 
Version Manager to the MacinUxsh last year and tiicy are currently 
working on a CodeWarrior plugin, PVCS is very powerful and 
flexible, but configuring it is not for the faint of heart, 

CONCIXISION 

Until about two years ago 1 had never used verston control. 
T had worked at several small companies all of which used die 
source tree method refeoTed to alx>ve. I even had one manager 
tell me in a meeting to temporarily restrict new features in a 
cross-platform applit:ation with #ifdefs because they were “tfie 
sign of professional code"! 

The first time 1 used version control was on a project in 
M.FW with four developers and I was amazed at how ,smoath it 
made our interactions. To l>c sure, Projector's locking 
occasionally caused conflicts, but compared to what 1 was used 
to, it was heaven. About a year after that project ended, we 
started Electric Fish with a fxm of a lyig Windows graphics 
package and we decided to use Projector and the ProjeetDrag 
applets (tliis was before CodeWarrior added version control 
c:apabilitie,s) ft wa,s ,so pleasant that we liave never looked back, 
and we started using ft for every small project tliat came along, 
even if only one of us was working on it. Eventually, we were 
u,sing Projec'tof so much that last summer 1 decided to write a 
Projector plugin for CodeWarrior. 

Every day, my partner thanks me for convincing him to use 
version control. I lu^pe that I have convinc:ed you a,s well. 

m 


Heip Make MAcIkH Work 


Here at MacTech Magazine, we rely heavily on 
outside writers for mosi of‘ the material that 
appears in our pages. If rcadcis did not 
participate in the magazine, sending us their 
ideas anti diking die lime lo wriie arlides, iliere 
would Ixt no MacTech, MacTech Maga^^tw is 
not a .staff of writem sending a coastanT .stTeam 
of one-way messages outwards; it's a living, 
evolving network of readers tT>nvensing with 
one anntfier, educating one another, sliaring 
their luiowledge, their experience, their inteiest, 
their trials and tribulations and joys and 
successes in the constantly unfolding story of 
programming the Macintosh. MacTech 
Magazim doesn't just happen: it's what the 
community makes it. Jf wc cany lepoits of 
future trends and teclmologies, if we teadi 


asefuJ mediods, if we review new books and 
tools, if we provoke tliouglit, prov ide help, ride 
the wave of cunenr interests and concerns, it is 
only because we reflect the thoughts of out 
readers, who speak rhix>ugh our purges. 

You are inviietl lo involve youTself in 
this exciling conversalion amongsi readers. 
No matter who you are, no matter what your 
credentials may l>e, if you liave a tale to tell, 
a trick to share, a lechniciue to teach, we 
want you to consider joining the family of 
those who write for MacTeck 

Don't just wait for a topic to be covered 
or a technique explained in MacTechf lake 
respcmsibility! Write us an article yourself 
To write for MacTech, just send for our 
Writer's Kit. It’s a Microsttfi Word file 


conlaining I he Slyles you need to use, and 
giving lots of lielpful advice and inrorinarion, 
including all lire legal slufl. You can let us 
know what you Ye writing alx>ut, or, if you 
want to, you can just write the article and 
spring it on us when it's done. [Note: We 
also have a need for people willing to make 
themselves available to write occasional 
product/lxx^ik reviews.] if wc publish your 
ankle, you'll he paid for it! 

Write to us, the editorial staff, at 
cditorial@macicch.com (or one of ihe other 
addresses listed on page 2 of the magazine). 
Take die future of' MacTech Magazirte into 
your own liaods! 

—U A G 4 2 k N E 
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FROM THE 
FACTORY FLOOR 


by Datfe Mark and Ron Liechty, ©1998 by Metrowerks, Inc., 

Ron Liechty, Metrowerks Ombudsman 


This montli*s interview is with 
Ron Liechty* Metrowerks' official 
online voice of reason. FVc long had 
this suspicion that Ron does not sleep. 
Ever, If Vm up on line at 3afn and post 
something lo Ron, I get an instant 
reply. 9ara* same thing. Idpni, same 
thing. 1 have yet to catch him napping. 
Ron, what is your secret? 

Ron liechty ts the ombudsman 
and the award .winning online 
representative for Metrowerks. His e- 
maii tax is always open at 
<MWRon@metrowerks.com>. Although a 
gra ndfether with two grandsons Jaymz ! 
and Jaysn and a granddaughter 
Odessa, Ron fiiitfe time to ride his 
inotorcyde when the weather is nice. 
His blest bike is a 97 HarteyTDavidson 
Dyna Convertible that lias been - 
lowered and sports a wide glide tank 
and tahcT custom adchtions. 


Dave: Ron, how did you first hook up 

with Metrowerks? 

Ron; 1 was an early member of the 
CodeWarrior team and t|uite proud that 
my employee 11) is a single digit. In 
March of 1994,1 was a forum leader on 
America Online and also teaching the 
online C++ course for Brian Novack 
who liad worked widi Creg Galancxs 
lx?fore. CtxieWarrtor DR/2 was about to 
ship and the first Apple PowerPC 
computers would lx: liiuing the shelves. 
Greg wanted someone to monitor die 
AOL, CompuServe and Intemei groups 
lo iielp fledgling Warriors, When Brian 
heard that Greg was looking he 
recommended me for tlic job. After 
some dLsemsion with Greg oniine about 
wliat my duties would be Greg Galanos 


and Jean Belanger decided to take a diance on me and 1 joined 
Metrowerks. 

Dave: What exactly is an Oiubudsiiian? 

Ron: An ombudsman is an agent of the company appointed 

by the company to rcfjrescnt its customers, Greg Galanos and 
Jc*an Belanger have always stressed the philosophy iliat 
Metrowerks does what is right for our users and this 
fundamental principle lias ixx:n passed along to all Metrowerks 
employees. I am fust lucky enough to lx: the public figure ihai 
our users see. 

CodeWarrior was to have two development relc*ascs and then 
the 3rd version of CodeWarrior was to be a ftiU release. 
CtjdeWarrior 3 was not up to the standard of a release product 
so an extra Fourth of July CD was i)ymi and sent to all 
registered CodeWarriors. 'fhi.s is the care and concern for our 
tustomers that dominates Metrowerks today. 

Greg Galancxs ha.s had an open cioor policy and as Metrowerks 
grew made tt clear that also extended to die research and 
development and operations departments as well. It is the 
open door to everyone in the company that allows me to be 
an effertive agent for all our users. 

Dave: You must live on the nets! Can you list the 
newsgroups and online services you monitor for 
Metrowerks? 

Rom Mast people are familiar with my work on 
comp.sys.mac,progranimer.codewanior, that I will generally 
read five limes a day, 1 read cnougli of every message pasted 
tlieie, Ox>lh (]uestioas and all replies) to determine if this is a 
tec'hnica] or a programming question. I also read the messages 
on comp.sysjmc.oop.powerplani several times a day. 

1 browse all of the camp.sys.mac.progmniming and a>inp.c)smv 
windows.pn)gfammer.ECKjls.mis^^ several times a day. In addition 
to these newsgroups 1 browse about 12 otlier newsgroups 
looking for subjects iliat may alTeci Metrowerks or our 
aistomeis. Besides the normal newsgroups I monitor the 
Metrowerks forum on CompuServe. I used to moniior America 
Online and GEnic l>ul they no longer have appropriate ibrurns. 
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Dave Can you catq^orizje the types of traffic your kwk out for? 

Ron: I not only read Llie messages in order to help our users, 

f also try to get a feel of whal our users want and liow llK‘y 
feel alxHiL Metrowerks. ^Iien users are upset or the same 
problems crop up repeatedly I rei^rrt Uiis lo management so 
changes can \ie made. When users praise CodeWarrit>r I pass 
this on so credit is given to those responsible. 

In tlie newsgroups that are not siiedhc to Mefrowerks 1 l<x>k 
for people that may have a common problem aSvSoctated with 
Metrowerks or any messages with Code Warrior or a .short hand 
for CodeWarrior in the title. I look for angry postings to l^e sure 
they aren't directed at CtjdeWarrkjr. On tlie generic Java or 
C/C++ newsgroups 1 will look for any messages concerning 
Mac^s. i will also read random messages that catch my eye. For 
example Pascal messages that deal with ThinkPascal. 
Questioas and the respoases to than are useful for directing 
the Rirtire of our Pa.sc;il develo[)mcnt. 

Dave: Outside of newsgroups aud e-niaU, witli wliat net 
events have you been involved? 

Ron; Metrowerks has hasted several live meetings on America 
Online wiili Greg Gakinas and other top engineers answ'ering 
<]uestions. Tills jive interaction is great to get a pulse of otir 
users and set* how they feel about taxleWarrior, iLs prtKlucls, 
and tile direction in which we are moving. 

1 also worked in the background to arnmge for Greg Galantxs' 
live appearance cm the Intej’nel Raclicj show ""1 lacker?/^ 

As a public figure for Metrowerks I am often contacted l^y 
authors and 3rd pany vendors and ettn initiate their interaction 
with Metrowerks. 

Dave: What else do yttu dt> at Metrowerks? 

Rem: J also do let Imical writing in my spare time, I write and 

maintain the MSI C anil MSI C++ References. 

Dave: There have been some excllhig changes in the 

Standards lately. Can you comment on this? And tell us 
where you go for your standards info. 

Ron: Yes Dave, most people are :iware of the changes made to 

C++ now that we Ijave a Working Standaal. Howevei; there is 
also the new'J1'C1/SC22/WG14 N79^ C Standands as well. Tlierc 
is a lot of work Co Ixf done and I try to take a week off the 
new.sgroups ewery .so t>lten lo devote to just writing. 

Tlic C standards commonly known as C9X standards are 
the biggest expansion of C since it wa.s first .stiindardized. Tlie 
new standards add a lot of new math routines and wide 
i haraaer functionality among other library additions. Some of 
the more popular C++ language components such as // style 
cottimenis are also added to the standard language. 

Adding the new wide character Cwchar_t type) support in C 


requires two new headers wctype.h ;md wchar.li. Wliilc the 
wctype.h is pretty much a rcfilica of the familiar ctype.h header 
except for the wide character type. WefiarJi is much more 
complex and is the largest header in the C standard library, 
Wchar.h covers much of the sUing.h, stdio.h and stdlib.h 
functionality for wcliar_i wint_t types and the null teniiinated 
mullibyte wide-character sequences. Typiciilly the hmitions for 
wcliarj are namexi with a w in their name such as wscanff) or 
wprintfO that are the wide character eqiilvalent.s of scanfO or 
printfO. The wide character string funaions replace str witli 
wes in their names. For example, wesepy is the wide character 
string equivalent of strepy. 

Ifi nc iude <wc ha r. li ^ 

mainO 

[ 

wchar^t naffletBl] “ L**"; 
wcscpyfname. L^Ron Liechty"}; 
wprintfCL^My nanje is Xs"*. nanie); 

return 0: 

1 

Wide character siring literals are designated witli a L"... “ 
declaration but much of the rest of ti is similar to the standard 
ANSI Character set. One significtini difference is that the end of 
file charaaer is WhOF. 

The official Committee DiKiirnem (CD) for C9X is (at the time 
of tills interview') available to the public:. Tins documeni. 
known as N262(), is available electronically from 
<www.dkuug.dk/JTC 1 /SC22/open/n2620/> in FtJstScript, Adobe 
Acrolial and Umx loniiatted text version. A press release i.s also 
available at <http://www,ndts,org/press/1997/pr971S7.htni> and this 
lists a place where you can purchase the .standards. 

It has l>een a liard task trying la ckKumem tfie C++ Librari<^. sinc:e 
they liave exixmded so muth Ixyond the old AT^&T CFront 
standanLs tluit most okler Ixxiks deal witli. T felt il was essential to 
annotate the stream libraries IxxniLse this Ls whai liic CFnmi 
litiraries primarily detdt willc In llie futtia" I will document liie new 
STI facilities of ffie libraries ami ilicn annolaie tliaii,, 

I retuntly was fortunate to work as llic facilitator with Stephen 
Pnita so that his laiesi edition the C++ Primer Plus includes 
a version of CodeWarrior Lite. Ihis Ixjok is the first popular 
book to deal with the Final Draft [ntemational Standard C++. 
Tile entire Metrowerks team did yeoman duties adjusting die 
compiler and Metrow^erks Standard Libraries to enable 
namespace std anti other STI. ftmctionality. Tlic information on 
tlus book is... 

Mitchell Waite Signature Series: fr++ Primer Phis Third Edilion, 
Stephen Prata. 

Waile Group Press (.sob.sidiary of Macmillian Computer 
Publishing), ISBN# 1-57169-1314. 

I'm very impressed with this Ixxjk. It is over 1000 pages and 
covers new and old C++ features like HTIT, Fxcepiions, STL 
container classes, etc. in a way that interesting and often amusing. 

AnotliCT lxx)k for those interested in the C++ standard is Bjarne 
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‘In just a few seconds I've successfully tracked 

DOWN A MEMORY CORRUPTION aUG THAT HAS BEEN ELUD¬ 
ING ME FOR ABOUT 3 MONTHS. FANTASTIC 

-Bryan Christianson- 


5F0TLIQnT 


The #1 Macintosh bug detection tool! 


• Detect memory leaks automatically 

• Instruction level bounds checking 

• Validate 400 Mac Toolbox calls 

• Pinpoint stale handle usage 

• Integrated with 'all Mac debuggers 

• Debug shlibs and.stahd alone code 

• Faster than ever, before 

FREE 

REMO , j?' 



94t.795.7801 Fax: 941.795.5901 
www.onyx-techxom sales@onyx-tech.com 


StoustrLtfi's Tilt: C++ Pr^JgraiTiniing Language, Third Edition: 

The C‘++ Programming Language Third Milion 
Bjamc Sirousinip 

Addison-Wesley fhihlishing Company 
ISBN# 0201^54-4 

There is no legirimate source for the FDIS vemion of the C++ 
Standard but you can find die last Deceinlx^r 96 Working PafXT 
version of IBe C++ Stanckrd at 
<dtp://researchjtt-com/dist/c++sld/VVP/CD1/> 

You can also purcliase a copy of the standard from 

CBF.MA 

1250 Eye Street. Suite 200 
Washington, DC 20005 
'lei: 202-737-8888 

'Fhey have not set a purchase price yet, as die international 
standard has not yet l'>een fuializd. bur by die time this 
interview hits die sUvcts, die standard sliould lx finalized and 
the price should be set. 

Dave: I understand that you like to teach online as welL 
Where would you point a beginner to get their 
programming questions answered? 

Ron; Yes I still teach a class on Ameriai Online on Sunday 
nights, it helps to keep me in touch widi novice progminmers. 
I’ve had all ranges of students from diose that never took a 
prognimining course to several NASA engineers trying to get a 
grasp on C++. It's a non-accredited course so you prctiy much 
get out of it what you put into it. 

My philosophy Is that learning occurs in three stages. Ibe first 
stage you know nodiing and know' you know' nothing. 'Ihe 
second .stage you know a lot and Ihink you know it all. Tlie 
final stage you know' a lot but realize diat ymt really know 
n(Xhing. I feel if I Cdn help niy studenLs over the second stage 
that Is all I can do, 

Mac OS programmers are lucky in that the eagerness to help 
each <.)ther seems almast boundless. Besides the newsgroups 
such as comp..sys.mac.programmer.help and 
comp.sys. mac.program mecco<lewarrior there are several 
organizations lliat are eager to help Mac OS prograniniers. 

One octePent ciitoiial site nnline Is Madntosh C by K. J. IMcknell and 
Matiniosh Vdsaii by Kof)m Grant and K. J, Brickneli 
<dittp://cafeArrtbrosiaSW.CDm/alt^^ This is an occdlent 

tutorial ske for Ixxli Macintosli C and Macintosh Pascal b^^inners. 

Tlie AIMED oiganization has a Study Course / Mentor program at 
<http://www,themost.org/>. This site qualifies students for an 
Academic version of CrxleWarrior if the}^ meet the MOST Jkandards, 

For programming restjurces <http://www.program.com/mac/> is an 
useful web site with links to Mac OS programming resources. Of 
course MacTech Magazine <http://www.madech,com/> is helpful 


for prognammers both new and experient:cd, Mi'inAverks also 
provides an excellent site for additional links 
<http://www.metrowerks.corn/tools/> 

1 regret that I am leaving out many ureas such as Wamt>r World 
for PowerPlant prtigramming <ww-general@codewarfior.org> and 
nuiny list servers, too numerou.s to mention. 

Dave: Any closing thoughts? 

Ron: Working for Metrowerks has liecn and extremely 

rewarding job. I especially like lielping novice programmers. 
Having been self taught in C++ and I understand tiie confiision 
and problems tli^it one can get into simply because they don’t 
utideiT^tiind the jargon. 

Metrowerks engineers have Ixxn very patient w'ith me when I 
pester them with qiicstioas and often follow^ up w'ith more 
questions to clarify' a statement. 1 don't w'ant to just answer a 
question. I want to answer a question in a manner that the 
questioner w ill understand. 

While the ccxsi of Metrowerks CodeWarrior Professional is a 
small factor in the corporate world {It ccjsls less for a 50 seal 
site license than the seats the engineers are sitting on), for a 
person programming as a liobby or sc’lf education the cost is 
real I am glad tliai the online exposure that Metrowerks 
provides to these budget minded warrior.s i.s pait of the value 
of CodeWarrior. K 
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PROGRAMMER'S 

CHALLENGE 


by Bob Boonstra, Westford, MA 



Blackjack 

This month we welcome you to the Programmer's Challenge 
Casino, grease your palm with 1000 Programmer's Challenge 
Credits (not to be confused will) Challenge points) furnished by 
the house, and invite you to spend a few milliseconds at our 
Challenge Blackjack table. 

The prototype for the c(xle you should write is: 

#if defined („cplusplus) 

extern *C" I 

#endlf 

Ipragma cnunsalvaysint on 

typedef enuffl I kHiddenSnit^O ,kClub,kDlaiiiDTid, klT^art. kSpadn t 
Suit: 

typedef enuM t kHiddenSpot= 0 , 

kAce*kl.k2,k3.k^,k5.k6,k7,k8*k5*k]0*kJack»kQneeii,kKing 
I Spot: 

typedef at fuel Card I /* and spots for a card 7 
Suit suit: 

Spot ^pot: 

I Card: 


kDealerWinsB lack jack, f deakr has Blackjack.^ou do not, no card dealt.you lose 7 
r these result.s are possible after you kStaiidl^it or kGaimfilackpack 7 
kPush, t dealer has santc score, no win or loss 7 

t these fesiilts arc possible after you kSiandPai 7 
kDealerBusts * /* dealer went over 21, yt>u win 7 

kOealerWinsHiTotal ♦ P dealer has lower mud, you hwc 7 
k¥ ouWinHiTot al P you have lower total, you win 7 

1 Raault; 


typedef void BetProc f P place a bet for this 7 

unsigned Int botAMOiint * p amount you bet. must be >= minfict and <= maxbct V 

Card yourHand [2] , P your initial hand 7 

Card dealerHand [2] p dealers initial hand, ftrsi canl is hidden V 

): 


typedef Result HitProcC /* returns result for this hand 7 

Ac t i on your Act ion, /* hit me or noi, spl it or not after intdal pdf, 7 

P double down or not after initial two cards 7 
floolean insurance, /*TfttJK ft^tucsts insiinmcc when eligible 7 
P these items are alwa>'s returned 7 
Card you rCa r d s [ ], /* all of your cards, including a new hit 7 

! n t * numYou r Ca rd s. P numbo" of cards in youK'aids */ 

P these items are rciiimcd when result is not kKoResuli 7 
Ca rd dealarCards L J * P dealers hand, with hidden card revealed 7 
P (ltdp® with canl counting) 7 

int * numDealerCar , P number of cards in dealers hand 7 
int ‘yourWinninge P winnings are positive, loss Ls negative 7 


typedef enum { 

kStandPat“0, P no more cards for this hand 7 

kCl aimBl ac k j ack, Pit yovir initial cards are Ace and a face card 7 

P the fhliowing values request another card 7 
kSplitAndHi /* only valid wiili tnitial pair showing 7 

kHi tHe. P request another card Ajr this hand 7 

p the following values request one more card 7 
kDpubleDownAndHitMe P only valid with initial two cards 7 
1 Action: 

typedef enum t P results of your request for a eanJ 7 

P this result is possihk anytime after a rule violation 7 
kll legal Play" -1, P illegal pby causes bsa of your bet V 

P these remits are possible after you request another eattl 7 
kHoR e e u 1 t“CI, p play again if you like 7 

k¥ouWin5CaedCharlie, P you have five cards and do not bust, you win 7 

kYouBust, P your card puts you over 21, you lose 7 

P this result b only possible after you kOaimBlackfack in the initial callback 7 
kYouWinB 1 ac k j ae k, P you have Blackjack and dealer does not, you win V 

P ihb result b only ptwwible after initial callback for a game 7 


void fnitRlackjackl 

liu Tiumtlecks, 
int yourBankroil, 
int winBet. 
int roaxEet, 
BetProc laakeABet, 
HitProc hitMe 

}; 


/* number of decks used by the dealer, 2. J<)7 
P number of credits you have to start 7 
P minimum bet lor och hand 7 
P maximum bci ftir each hand V 
P eaJIhack to place a wager 7 
P callback to get a card 7 


Boolean Blackjack( P return true to keep playing, fabe to cash in 7 
Boolean ncwDeck Tiim* wlKmdeaha-stares wkbfteiihramillceksdtsdo of 

); 


#if defined [_cplusplun) 

I 

^endif 

Pby at die Challenge Ci^sino liegm.s with a c'.all to 
InitBlackjack, where you are told how many decks the house uses 
(numOecks), liow many Credits you have to work with 


THE RULES 


Here's how it works; each month we present a new progmmming 
challenge. First, write some eode that wives the challenge. Second, optimise 
your code (a lot). Then, submit your solution to MacTeeh Magajiine. Wc 
choose a winner based on eode ctjiTectne,ss, speed, si?.e, and elegance fin 
that order of importance) as well as the submission date. In the event of 
multiple equally desirable solutions, well choose one winner (with 
honorable mention, but no prize, given to the runner up). The pilie for each 
month's best solution is a $100 credit for I>eveloper Depot™. 

Unless ^aated otherwise in the problem staiemenl, the following rules apply; 
All solutions must be in ANSI compatible C or C++, or in Pascal. Wc dLsqualtfy 
entries with any assembly in tliem (except for challenges specifically statmg 
oUiowbe.) You may call any Macintosh Toolbox routme Ce.g,, it doesnt matter if 
you use NewPtr instead of maJioe), Wc conqMle all entries into native PowerPC 
eixk with amipilcr options set to enable all available speed optimkaiions. The 
development envifonmeni to be used for selecting dje winner will lx; stated in the 
problem. IJmil ycMr eode to 60 ebawters pa- line or aimpress and binbex ibe 


solution; this hdps with e-mail gateways and page layout. 

We publish the sdutlon and winners for each month's Piogmmtnef.s 
Challenge three mondis later All subtnissions must lx; received by the 1st day 
of the month printed on tlie frtmt cover of this issue. 

You can get a head start on the Challenge Ity reading the Programmer's 
Challenge mailing Ibc It will be posted to the lust on or before the 12lh of the 
preceding month To join, scnrl an email to lisf.servi3)lLstmail.xplaiacom with 
the .suhiect “.subscribe challcngc-A". 

Mark solutions ‘Attn: Prograntmer's CluUenge Solution' and send it by 
e-mail to one of the Prograiiuner's Challenge addresses in the ‘'How to 
Communicate Witli Us* secUrm rm page 2 of this issue. Include the solution, 
all related files, and your contact info. 

MacTech Magazine reserves the right to publish any solution entered in 
the Programmer's Challenge. Authors grant MacTech Magazine tJ>e exclusive 
right to pubJj.sh entries without limitation upon submission of each enUy. 
Authors retain copyrights for the code. 
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(yourBankroll) a>urte.sy of the house* the niiiiimuni {minBet) / 
maximum (maxSet) i>et pur hantl at the Ca.sim>* how to [>iace a 
but (ihu makeABet callback) anti liow ask for another card (the 
hitMe callback). Business is slow at the Casino, and yrni are the 
only player at the tabic. 

After the call to InitBlackjack, your Blackjat k routine will lx? 
called rufKiitedly until you run out of Credits (in wliicli ease \w 
show^ you the door) or until you decide to cash in. The house is 
certiJin that you are not a card counler.^ so they make il very 
obvious when they are starting with a fresh set cjf numDecks 
decks of cards by seiiin^^ the new Deck piinrnieten 

The first thing your Blackjack r>uL ine .should do is call the 
makeABet cullbat:k to make a wager and obtain your first ciiixls. Ttie 
dealer alst^ receives Lwf> cart Is, one t>f w hich ytm c'tin see and t)nc 
of whitii is face clown (kHiddenSuit and kHiddenSpot). the dealers 
hidden card will lx rcfvealed to you only al tile end of ihe hanti. 
After you gel your c’ards* you c!an repc^atedly ru^juest an additional 
card by nilling hitMe witli yourAction set to kHitMe until yoti Ixdieve 
you will win ihu hand or you bust. Another caal will lx added to 
yourCards and *numYourCards will lx incrementCLi. You win at 
Blat'kjatrk by obtaining a luind total tliat is less than or ecjiial to 21 
and at die same time is higher ifum the total in die dcaler^s hand. 
Cards are counted at tlieir fac:e value (i.e,, (int)tbeC3rd.spot)* except 
for aces and picture cards (Jacks* Queens* Kings). Pitturt^ uircLs are 
counted with a value of iO. Aces can Ix^ counted as either I or II, 
at the option of die player (In our game, the hitMe routine will 
sc’ore Aces to your best advantage* giving y<x lUv. highest ptxssilile 
hand total without cixctxding 21.) 

As long as your card total dixs not exceed 21, hitMe will 
return kNoResult and you nuiy keep |daying. If your total exceecLs 
21, hitMe will return kYouBust, in which case you lose regardless 
of what the deidcr holds. If you dnivv a fiftli card without going 
bust, you have a Five Card Charlie, hitMe returns 
kYouWinSCardCharlie. and you wan. 

When you are rmislied rct]uesting aclditional cards, you 
should c:all hitMe with yourAction set to kStandPat. The dealer will 
llien draw' cards until s/lie has a total of 17 or more, and hitMe 
will return kDealerBusls if die dealers total exceeds 21, 
kDealerWinsHiTotal if the dealer's total Ls greater than yours, 
kYouWinHiTotal if your total is greater than the dealer's* or kPush 
if yoLtr total and tlx dealer’s are the .same. In addition, 
*yourWinnings is set to the net change in yourBankroll. In the case 
of a tie, or 'puslf, *yourWinnings is set to zero, In all cases, the 
dealer's full hand is [xovided in dealerHand once the result of the 
hand Ls determined, and ‘numDealerCards is set to the niimlxr of 
entries in dealerHand. 

If your first two cards are an ace and a lO-valiied card Ca 
ten or a face card), you should call hilMe with yourAction set 
to kClaimBlackjack and hitMe will return with kYouWinBlackjack 
(unless the dealer also has a blackjack). If the dealer’s flusi 
two cards are an ace and a 10-valued card, the dealer has a 
blackjack and hitMe will return kDeaIerWmsBlackjack, unless 
both you and the dealer have a blackjack, in which case the 
result is kPush. No additionai cards are dealt when either 
player has blackjack. 


You bive the oj^lion of kJt sibling tlown' after Itxiking at your 
Hrsi iw^j cards by calling hitMe with yourAction set to 
kDouhleOownAndHitMe. 'Jhe hitMe routine will double your Ixri, give 
you one mote card, play the dtftiler s hand and letiirn the ixjsulu 
[f your first two cards are idenlicai in value, you may 'split' 
the luinU and play each card separately. You do this by calling 
hitMe with yourAction .set to kSplitAndHitMe. Play the first hand as 
usual, but instead of returning wJien tlx ha ml is finished, call 
hitMe with yourAction set to kSplitAndHitMe again to play the 
scTond hand. You may only split on the initial two cards, no! on 
any suhscx|ueni pairs. You cannot double dow'n on a .split hand. 

When the dealer s exposed card Is an ace, you are allowed 
to rec|ue.st iasurance of tme half of your original Ixt, If the dealer 
has a blackjiJck, insurance proiecus you from losing your initial 
Ixt (i.e., your net winnings are zero). If the dealer docs not have 
blackjack, you lose* the insurance amount and win i>r lose* the 
iniiial ixt based on how the liand plays out. 

Oh, and for those of you that think ganibling doesn’t pay, 
we must iasist tliat yt>u actually wager those Challenge Credits 
initially provkied by the hou.se. Your [K)inl Uital will he reduced 
by a ‘freeloader penally’, tlie nunilxr of your initial yourBankn^ll 
oi’ Credits that y(Xi fail lo wager. Once you have wagered 
yourBankroll crtsJits, you are free lo conlimte playing or retire 
with your remaining funds without penalty. 

'I'he (dullenge winner will lx the player that accumulates 
11 1 C most points, where: 

Points - OediLs at game end h milliseconds played fi 
freeloadet' jxnally 

Til is will be a native PowerlC Cliallengc, using the Qxle Warrior 
eiiviromnem. Solulions m:iy lx* coded in C, C’*^, or Pascal. 

Three MomiLs Ago Winner 
The Mareli Challenge was to efficiently kleiitify a st^quence of 
airline flights dun would lake t>ne from an origin to a destination in 
the minimum elapsed time* coping with die uncertainties of airline 
travel. Congratulations to WiEkke Riekexi (the NetherlarxLs) taking 
first placx:' in die Help Peter Cel Home Challenge, Willeke won 
based on liaving fewer viokttioas of dx* mininium connection time 
con.srrjint specified in the problem statement, wiiich restilted in less 
penalty' time Ixing added to liis sokjtEt)n. 

Hu* winning stikition is a little lough to read Ixt aiLse Willeke 
afiparenUy Likes to lx fnigal widi commentaiy. He begins by 
builtiing wliat he calls a forest’ of Depamire rex orils that asstxiate 
each airline fliglx with tlie depaXure and arrival airport rct“ords. 
The work vs tlien done by the FlyHome methiKl of the Ajrj> class 
iastnnee nssrxiated with the departure airport. FlyHome then calls 
CalcRxp(XtedTime for pros|xaive inlenitediaie stops, which in 
turn calls (uilcExpectedTime for sulisequent mtermecliate stops, 
eliminating dead ends and (ligliLs that result in loops. When tiie 
fxesufued fasicsi route Is found, the Juin|>OnAldane metlKxl is 
called to actudly commit to Diking die first flight scgmetit, after 
wiiich FlyHome is called for the intermediate airport ttJ repeat the 
jmxess with the intermediate airjxut as the dcfiarture p«jim, 

I used 12 random test CAses to evaluate die solutions. Hie test 
cases resulted in lx*twccn 1 and 5 Ifiglii segments per aise* for a 
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total of --40 flight .segmcnls, E liad hoped to use a digital version of 
the international airline guide to evaluate the solutions, l>uL I was 
unable to obtain the guide until the last minute, and unable to 
reverse engineer the data slructuies in the time remaining- 1 was 
able to reverse engineer the flight schedule used on the Air Canada 
web site, containing the Air Canada flight database and a significant 
number of connecting flights from other airlines- I supplemented 
this with selected flights entered manually from a haida)py of tlie 
international OACt, along with sf)mc arbiir^' manual data. Note to 
self: sleep Is a valuable thing h think more carefully about how you 
are going to test these Challenges in the hituie. 

ITie table below shows tlie total fliglil lime in hours for the 
12 lest, followed by liie execution time in milliseconds, and the 
nutnlx?r of 24-hour penalties imposed for violating tlie connection 
time restriction imposed by tlie problem statement. Tlie exeaition 
time, weigliLcd so that one second of run time etjuales to one hour 
of simulated flight time, is added to the flight and penally times to 
obtain the final score, with a lower score lieing lietter. Finally, the 
table lists tfie ctxle siise, data size, and programming language 
used for each of the solutions, 'Ihe number in purenlhe.scs after a 
contestant's name is the tf)iai number of Challenge points earned 
in all Challenges to date prior to this one. 


Same, flight 

Time 

Hxt^artion 

Pcnaltks 

Score 

CckIc 

Data 

tang 


(houfs) 

(msecs) 

(24 Imiurs) 





Willeke Rieken (27) 

358.4 

im 

1 

383.6 

.3424 

132 

C++ 

Ernst Municf 652) 

356,5 

354 

2 

404.9 

4164 

1096 

C++ 

Alan Halt (14) 

414.8 


2 

463.8 

5508 

168 

C++ 


ToH 20 CONlliSTANTS 

Here are the Top Contestants for the Programmer’s 
Challenge, including everyone who has accumulated more than 
10 points during the past two years. The numlx^rs below inciude 
points awarded over the 24 most recent contests, including 
;x)ints earned by this montIVs entrants. 


Rank 

Name 

Points 

K^tnk 

N:inie 

Pt>inLs 

1. 

Muntcr, Ernst 

228 

9. 

GreRi>, Xitn 

24 

2. 

Boring, Randy 

73 

10. 

Murphy. ACC 

24 

3. 

Cooper, GrcR 

61 

11. 

Hurl, Alan 

21 

4, 

Mallcct, Jeff 

50 

t2. 

Day, Mark 

20 

5. 

Rieken, Willeke 

47 

13. 

HiRRins, Charles 

20 

6. 

Nia>lk, Ludovic 

3^1 

14. 

Hostelter, Mai 

20 

7. 

Lewis, Peter 

31 

15. 

Snider, Thomas 

20 

8. 

Antoniewic/, Andy 

24 

16. 

O’Connor, l urlouRh 

14 


There are three ways to earn points: (1) stioring in die top 5 
of any Challenge, (2) being the first person to find a bug in a 
published winning solution or, (3) being the first person to 
suggest a Challenge that 1 use. 'I he points you can win are: 


Here is Willeke's w'inning solution to the Help Peter Get 
Home Challenge. 

HeIpPeterCp 
Copyright 1998, 

Willeke Rieken 


// FindQuidcsUtouie 

If Include "helppeter .h“ 

^include <stdlib.h> 
^include <atrlng.h> 

Ifdefine kKinlnADay 1440 


class Airp; 

class Departure 
class Departure//fliBhis 

I 

publics 

Airp ‘TDestlnattorn 
Oeparture * FUex t nepi 

long fScheduledDepa r t u rcTi me; // minutes alter miiini^^iL 
long fExpectedFiightDuriitlati: 
long flimeOffset; 
long fFirstArrival: 

FHghtNuni fTllghtNunsber; 

DayOfWeelc fEirstStartDay; 

Boolean fOperatlngDaysf71 ; 
static GetFllghtTiiic fGetFl ightTinie: 

Departure[Flight *theFligtb> long theTineOffeet. 

Airp *tbeArrAirp): 

void SetFirstArrival(DayOt¥ee]i theStariDay^ long theStartTime* 

long theCuniTime): 

long CalcExpectedTlmeCAlcp ’theEndAirp. long LbeFastestTijEe); 
long JurapOnAPlane[DayOfWeek theStartDay, long theStartTime* 
Airp *theEndAicp): 


class Airp 
class Airp 

I 


pubi Ici 

static Alrp^’fAllAirports; 
static longfKumAlrportft: 

Departure 'fFltstOep: 
long flimeOffset: 
long tHinConnectTljne: 
long fFirstArrival; 
long fPrevArrival: 
long fPtevTiine; 
short fBeenHere: 

UayOrWeeV fFrevOay; 

AirpEAlrport *theAlrport); 

"AlrpO ; 

void Addi’light (Depaf Mjre 'rheDep): 
void ResetFlrstArrivalstJ: 
long CalcExpectedTicie(DayO£Week theStartDay, 
long cheStartTime, 

Airp 'theEndAirp* long theCutnTlJiie. 
long theFastestTime); 

long FlyFo[iie(DayOfWeek theStartDay, long theStarlTJine, 
Airp *theEndAirp); 


GetFlightTitiie Departure r jFGetfligbtTliie * 0; 

Departure:;Departure 

Departure: :Departure{Fllght ’theFlight, long theTlineOffset, 
A 5 rp *TheArrAirp) 


1st pbc:e 
2nd place 
3rd place 
4th place 


20 points 5di place 2 points 

10 points Finding bu^ 2 pt>inLs 

7 points Suggesdng Challenge 2 points 

4 jx>inis 
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r 

fBeetitiation - thcArrAirp; 
fNextDep 0; 

strcpyirFllghtNumber. theFiiabt->fllghtNiimber); 
fSchsdul&dUepartureTliie ** 

theFlight->schGduledDepactiireTine,hour * 60 + 

til ell i gh t - > flc bed li 1 edOe pa r t u r eTirae * ni n r 
tExpectedFlightOuration " 

theFlight->nominalFIighiDuration.hour * 60 + 

theFlight >iioaiiiiaiFlightDuration,min • 
((1 / theFlight’>laE!bdaDeparture) 4 
(1 / theFlight->iajnbdaDurat!on) + 0,5); 
mcnicpy (I0p6*ratingDayfi. xhaFlightOoperatingDays, 7); 
fTimaOffset ^ theTimeOffset; 
fFlratArrival - 0x7fffffff; 


Departure::SetFlratArrival 

void Departure: iSeiFlralArrivaKDayOfWeek theStartDay, 
long iheStartTinte, long theCumTljiie) 

1 

longaTltne " tbeCuttiTime; 

// catculaic tiiiic spent at the airpcirt so Peter can eliminate 
// slowCT flights [0 tlie same aitpon 
if (fScheduledDepartureTIiic < theStartTime) 

{ 

aTiiae ^ aTlwe + kHinluADay; 
if (theStariDay ^ Saturday) 
thftStartDoy * Sunday: 
else 

theStartDay - (DayOfWeek)(theStartDay + l)t 

aTirae ^ aTime + ffScheduledDepartureTlne theStartTine); 
while C!fOperatlngDays[theStariDay]) 

1 

aTinie allme + kMinTnADay: 
if (theStartDay = Saturday) 
theStariDay " Sunday: 
else 

LheStartDay • (DayOfWeek)(theStattDay + t); 

] 

aTime = sTiie + fExpeotfidFllghtDuration; 
tFirstArrival ** aTime: 
ffFirstStartDay “ theStartDay; 

// store earliest arrival with the airport 
// I¥tcr can eliminate slower flights from other airport 
if {aTime C CDestination‘>fyirstArrival) 
fnGSl.inatlori'>fFlrstArrlval “ aTime; 


Departure:: Calc Exp ectedTiite 

long Departure::CaicExpectedTime (A irp *lheEQdA±rp* 
long theFantentTime) 

// liieSurtTime Ls local 

i 

// the time is calculated in SctHrslAmvaJ 
if ffDestination ^ theEndAirp) 

return fFiratArrival: 

1 

else 

r 

if (flirfltArrlvfll < theFasLestTline) 

E 

// keep track of the day of the week 
DsyOfWcek aStartDay ^ fFiratStartDay: 
long aStartTime “ fScheduledDepartureTine + 
flixpectedFlightDutation - fTimeOffEet: 

if CaStariTiiie > kKirvInADay) 

« 

aStartTime ^ aStartTime - kKinlnADay: 
if (aStattDay ™ Saturday) 
aStartBay “ Sunday; 
else 

aStartDay = (DayOfWeek)(aStartDay + 1): 

J 

else 

if (aStattTime < OJ 


t 

aStartTime aStartTime t kMlntnADay: 
if CaStartDay “ Sunday) 
aStartOay = Saturday: 
else 

aStarxDay (DayOfWeek){aStartDay - 1): 

1 

// calcubic atpccicd time to gci home from the next airport 
tong anExpectedTiiue = 

fOastlnation->CalcExpeetedTime(aStartDay. aStartTime. 

theEndAirp, fFlrstArrival» theFasiestTime); 
if (anExpectedTime > 0) 

return fFirstArrival + anExpectedTlme; 
else 

return anExpec t edTlme: // slower Or didn’t arrive home 

] 

else 

ret urn 1: //sbwci 

I 

) 

Departure::JumpOnAPiane 

long Departure::Jump0nAPlflne(DayOfWeek theSrartDay, long 
theStartTlme, Airp * theEndA1rp) 

// theSaitTime is local 

( 

long aTime = 0: 
long aFlyitigTime: 

/f catailate time until the plane wilt dep^n 
If (fScheduledDepartureTlme C rheStartTlme) 

{ 

// tomorrow 

aTime = aTime t kMlnInADay* 
if (theStartDay = Saturday) 
thoStariiDay “ Sunday; 
else 

theStartDay (DayOfWeek)(theStartDay ^ 1); 

aTirae “ aTime + CfScheduledDeparTureTlme theStartTime): 
while (JfOperatingDsyf! [theStartDay]) 

aTime = aTime + kMlnlnADay: 
if (thp.St.-3rtDay = Saturday) 
theStartDay = Sunday, 
else 

theStartDay “ (DayOfWeek)(theStartDay + 1); 

// calculate delays ami flying time 

aFiyingTime = (^fGetFlightTime) (fFlightNumber) : 
aTime aFiyingTime; 
if (fDestlnation ^ thpRndAlrp) 

I 

// Peter Is home and won't take another plane 
return aTime: 

1 

else 

i 

// kcqj track of Ihc day of the week 
theStarrTiBie += aTime ' fTirapOffnet: 
if (theStartTime > kHinlnADay) 

I 

theStartTltno LheStartTlme - kMinInADay: 
if ftheStariDay ^ Saturday) 
theStarlDny = Sunday: 
else 

theStartDay ^ (DayOfWeek)[theStartDay t 1): 

1 

elae 

if (theStartTime < 0) 

I 

theStartTime = theStartTime + kllinltiADay; 
if (theStartDay " Sunday) 
theStartDay Saturday; 
el ae 

theStartDay = (DayOfWeek)(theStartDay - 1): 

1 

// fly home ftoin die ncxi airport 
return aTime + 

fDes tination->F1yHome(t h eSt a r t Da y. 
theStartTime, theEndAirp); 
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Airp * *Airp: tfAllAirportt* = 0 ; 
long Airp:ifNumAirports - Oj 
Alrp::Airp 

Alrp::AlrpfAirport •theAirport) 

I 

Cl-’lrstDep ■ 0; 

fTinteOf Csui " thf^Ai rporr->tlineOff set .hour * 60 + 
tbeAirpori HImeOffset.iiln; 

fHinGonnectTiiae * theAirport >nilnConn(>cTTIiie.hour * 60 + 
t he Ai rp 0 r t - > mi nCo nue c t Tl me > m i n: 
fBeeoHere 0: 
fFiriJtArrlvel - 0x7fffffff: 
rProvTtme “ 0; 


Airpr :"*Airp 
Airp,:“Airp() 

I 

Departure ^aDep; 
while (fFiratDepi 
( 

aDep = fFirat0ep">fNextOepj 
delete fFlratDepi 
IFlrsiDep * aDep: 

[ 

Airp::AddFlight 

void Airp;;AddFlight(Departure HheDepI 

t 

thenep->fNextDep fFltstDepi 
fFirslDep * iheDep; 


Airp: rResetFlrstArrive I« 
void Airp:jReeetFiretArrlvals() 

I 

for (long aCount * 0: aCount < ffJumAirports: aCount+t] 

I 

fAl1AirportsfaCountl >f¥irstArrivai ^ 0x7fffftf£; 
fAl1Airport afaCount] OfPrevTlme ^ 0: 

1 

1 

Airp:rCaicExpectedTlne 

long Ai rpr iGaicExpectedTinelDayOfWeek tlieSiai Llliiy, 
long th^tartTiine, 

Airp •theEndAirp* long theCumTlmc, 
long theFastestTime} 

// ihrStannnvt is (iMT 
t 

// cak'ulaU' ihr tTiptrinl rimL- tti gfi home fnini ihbs airpim 
Departure *aFastesLDcp ^ 0: 

Departure ‘aDep - fFlratUep: 

Departure *aPrevDep ^ 0: 
longaFastestTitte = Ox/tttifff: 
long aTlme: 

IF (FBeenHere) return 1: //flying in daks 

if (I heCutiiT I me > f FI r «tArrl val) // thtrr b a fasitr wuy in gtt hra 

return 1; 

if (fPrevTiiiH; (fProvAr rival ^ theStartTime) Lk 

(t PrevDay ^ L hcSta rlDay)) // armr^d here at the same time ;U anoilicr try 

return t PrevTime : // ihr time to get lu}ine will be the same 
fPrevArrival = theHtattTlake: 
fPrevDay = theStartDay; 
fPrevTime = 0: 

// calnibte lime speni at thb airport 

tlieSlarLTlwo “ theStartTiiae 1 fMinCoimectTime + fTimeOffset: 
if (iheSLartTSme > kMinInAOay) 

I 

theStartTlme ^ iheSLarlTimo - kMinlnADay: 
if (theStartDay Saturday) 
theStartDay = Sunday: 
else 

fheSrartDay “ (DayOfMeek)(theStartDay ^ I); 

1 

oUe 

if (iheSlortTImn < 0) 


tbeStartTime ^ thoStartTime + kMlnlnADay; 
if (theStamDay ^ Sunday) 
theStartDay - Saturday; 
else 

theStartDay =■ (DayOt¥eekHtheStartDay 1); 

1 

if (ihcCumTiae f fMinConnactTime < theFasteatTime) 

I 

f Beeullero = I; 

// set Uic cirlifst arrival for every mherr airport 
// Peter ran fly to from this airpon 
while (aDep) 
t 

if {laDep’>fDestiiiation-HBeenliere) 
aDep->SetFirstArrivai(theStartDay * 
t heS ta r tTime. t he CutnTime): 
aDop "= a0fip-)fNflxtDep; 

] 

// try which fliglu might lx- the qukkest way home 
aDep = fFirstDep: 
while (aDep) 

\ 

if (!aDep->iDestlnation->f Betnillere) 

t 

aTime ’ aDep >CaleExpectedTi»e(the£ndAlrp* theFastestTlme): 
if (aTiwe > 0) 

I 

it (aline < aFastestTime) 

1 

aFastescTine = aTimci 
aFastestDep = aDep 
I 

aPrevDep = aDep: 
aDep “ aDep‘>fNeittBep? 

I 

elue 

if (1 oTime) // dllIn't arriVC homt- 

I 

// remove flight, it will never work 
if (aFrevDep) 

I 

aPrevDep-)fNextDep - aDep >iNextDep; 
delete aDop: 

aDop * aPrevDep->fNextDep: 

J 

else 

I 

fFlrsiDep ^ aOep->fKextDop: 
delete aDep; 
aDep - fFirstDep: 

I 

r 

elfie 

t 

// too slow <if giJing the wrong way 

aPrevDep ^ aDep; 

aDep - aDep >rNexttU>p: 

I 

* 

else 

aDep - aDep >fNextDep; 

J 

fheeullere ^ 0; 
it tfFirutDep) 

I 

if (aFsstestDep) 

I 

if (theCumTiJiie tUlnConnectTiiie ^ aFaalestTIme < 

theFsatestTiroc) 

i 

fPrevTtwe = fNinConneetTine + aFasieatTime; 
return fHinConneerTiroe * aPastestTime; 

1 

else 

ceturn -1; //slower 

1 

else 

return -L; //dkhiH lind a way howif 

i 

else 

return 0; //no Digths fnim here m thcFhdAirp 
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else 

return -1: //sbwcr 

I 

Airp: :FlyHome. 

tong Ai rp: :FlyHoin(5(Day0fWGGk theStartDay, lon^ theStartTime, 
Airp 'theEuMirp) 

// tJicistamimt is GUT 

i 

Departure *aFastestDep " 0; 

Departure ‘aDep “ fFlrstDep: 

Departure ^aPrevDep = 0: 
long aPaateurTIrae ^ 0x7fffffff‘ 

1 ong aTInie : 

if tfBeetiliere) return 1; //flying in drcJes 
fBeenllere “ 1; 

ReaetFlrstArrivals {) ^ // delays may thanp: ouiicst arrivais 

// talciMc the time spent at this airport 

theStartTitne fMlnConnectTime + fTEHteOf fsel r 

if {theStartTimo > kMinlriADay) 

< 

LheS Lai LTime = theS tart Tine - kKinlriADay: 
if (theStattDay Saturday) 
theStartDay ^ Sunday: 
else 

theStartDay = (DayOflfeek) {theStartDay + 1); 

elae 

if [rheStartTimo < 0) 

S 

LheStartTime = theStartTime + kMlnlnADay: 
if (theStartDay = Sunday) 
theStartDay =• Saturday; 
else 

theStartDay = CDayOfWeek)(theStartDay - 1): 

I 

// set the earliest arrival for every other airport 
// Peter cm fly to from tills airport 
while (aDep) 

[ 

it (iaDep'>fDestination-> fBeenHere) 

aDep->SetFiratArrival(theStartDay, theStartTime. D); 
aDep - eDep‘>fflextDep: 

1 

// try which flight might be the quickest way home 
aDep fFirsLDep; 
while (aDep) 

f 

it (!aDep ->fDestination'>fBeenHere) //don't fly in circles 
i 

aTiuie = aDep->CalcEa:pectedTiiiie(theEndAirp. aFanteatTime); 
if (aTimp. > 0) //found a way home 

I 

If (aTime < aPasteaLTinie) 

\ 

if tile (asics! urUil now 
afastestTime = aTime: 
aFastestDep = aDep; 

I 

aPrevDep = aDep; 
aDep = aDep->fNextDGpj 
I 

else 

i£ {I aTime) / / didn't arrive home 
f 

If (aPrevDep) 
i 

aPrevDpp->fNexrDep = anep->fNexLDep; 
delete aDep: 

aDep = aPrevDep->£NextDep; 

I 

else 

f 

fFirstDep = aDep■>fNextDep; 
delete aDep: 
aDep “ fFirstDep: 

I 

f 

else 

f 

// loo slow or going the wrong way 


aFrevDep = aDep: 
aDep aDep->fNcxtDep: 
f 

) 

else 

aDep = aDep->fNextDep: 

) 

if (aFastestDep) 

return fMinConneetTime 1 aFa,‘5tRstDep->JiimpOnAPlano{LheSLariDay, 

theStartTlraep theEndAirp): 

else 

return Or 


FindQuickestRoute 

long FindQuickeETRoute ( t return travel time in seconds 7 

Ai r p 0 r tilame d e par t ur eAi r p o r t, t origin airpon 7 

AirportHame arrivalAirport. T destination airpon 7 
Da yflfWe ek a r c D a y p /* day the adv<mtu re tx^ns (local time) V 

My Time s L ar tTlme. t time the ads'cnture begins (local time) 7 

Airport airporta[] , t places to fly from/io V 

long numAirports p r number of eniries in airpons[j 7 

Flight airlineSehedule []. t flights to choose from 7 
I on g numF 1 i gh t s p T number of entiieii in airUneSdiedule (] 7 

GetFlightTime rayGetFlightTitner callhaek that pnwitks acntal fi^ht <luration 7 


Airp*'arAirPotts ^ new Airp*[numAirportal: 

Airp *aS tart Airp = 0; //where Peicr starts 
Airp 'anEndAirp = 0; //Peiefshome 

Airp ‘aDepAirp, *ariArrAirp; 

Departure *aDep: 

long aAir pC ount. aFlightCount, aTime: 

// make a forest of the airports and flights 
if each airport has a list of flights from tliat airport 
if each fli^t points ro the next airport 

for (aAirpCount “ 0; aAirpCount < numAirports; aAirpCount-H-) 

( 

anAirPorts[aAirpCount] - new Airp(&airportsfaAirpCountl); 
if (Istremp(airports[aAirpCount1,name, departureAlrport)) 
aStartAirp = anAitPorta[aAirpCount]: 
if (!fitremp(atrports[aAlrpCouni].name< arrlvalAirporL)) 
anFndAirp = unAlrPorto[aAirpCountJ; 

I 

for [uFllghtCaunt = Q: aFlightCaunt < 

numFlights: aFlightCount-H-) 

f 

aDepAirp = 0; 
anArrAirp = 0; 

for (aAirpCount ” 0; aAirpConnt ^ nuaiAirports: aAicpCounL++) 

I 

if C [strcmpCalrporLstaAirpCoutil] .name, 

alrlineSchedulelaFlightCountj .fromAirport)) 

I 

aDepAirp anAirPorts[aAirpCount]; 
if (anArrAirp) break: 

I 

if ([atrciiip(flirparts [aAi rpCosmt] .name, 

airl ineSchedule[aFllghtCounL]. LoAirpot L)) 

anArrAirp - auAirFotts[aAirpCount] : 
if (aDepAirp) break: 

1 

1 

if (aDepAirp && anArrAirp fisA (aDepAirp 1= anArrAirp)) 

1 

aDep new Departure(&airlineSchedule[aFlightCount], 

aDepAirp->fTiiiieOffset^ anArrAirp) ; 
aDepAirp->AddFlight(aDep): 

! 

1 

Airp;ifAllAirports = anAirPorts: 

Airp;: fNemAirports =■ numAlrporte; 

Departure:; fGetFlightTime = uiyGetFlIghtTime; 
aTime = aStartAirp >FlyHome{s[;arlDay, 

atarLTimG.hour ‘ 60 + startTirae.miu n 

aStartAirp->fTimeOffeet. anEndAirp): 
for (aAirpCount ^ 0: aAirpCount < numAirports: aAirpCount++) 
delete anAirPorts[aAirpCount]: 
delete]] anAirPorts; 
return aTime * 60: 
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Plug In and Reach Out 


A plug-in arcliitecturc oin \yc a clever way to add power and 
value m your application. It allows third parries to extend the 
capabilities of your product, and allows ytm to do the same 
without the need to redistribute tlie entire application to end 
users, and witliout tlie danger of adding bugs to the core cckIc 
as you add features. 

Teh- Component Manageh 

It bi natunil to think of an application pltig-in as analogous 
to a system extension, but there is a crucial difference: extensible 
applicatioas are specifically designed to w^ork with plug-ins, and 
have a well-defined interface through which the plugdas 
operate, while INlTs usually do their work despite the lack of 
such an interface, relying on low-level mechanisms such as imp 
patching- As a resiili, plug-ins don’t bring the instability often 
assoi:iaLed with system extensions, and they tend to provide an 
a|>[>iication with a specifK- service or capal^ility, rather than 
nuxlifying global behavior 

Despite this distinclion, certain parrs of the Mac OS are 
designed to accommcKlate pkigdns, and ihey do so using a 
powerful tool that you can use to give your own applications a 
plug-in ardiitccLure: the Component Manager Apple likens the 
Component Manager to a Resource Manager which acts on 
funaion objeas nnher ihan data objects. If you Itave ever 
executed a compiled script from within an applk'ation, y{>u have 
u.sed the Component Manager. Many parts of the Mac OS are 
implemented via components—AppleScri|>t and Frontier are 
Scripting Components, QuickTime uses components for image 
dec:ornpression and for video effects, and the Translation 
Manager uses components to enai>le Mac OS Rasy Open to 
covert files between fonnats. 

Yt>u can write components which will only Ix.^ used by your 
applic'tilion, or w^hicli will provide their .services globally, to any 
application which recjuesis tltem* Start learning atotit the 
Component Manager from its chapter in Inside Mat:inLosh: More 
Macintosh Toolbox, and then visit the QuickTime 3-0 
documentation for recent change.s. Also be sure to look at the 
sample code which Apple has provided, 'fhere i.s older code, 
which shows you how to write a simple c:omponenl, and newer 
code on the Quicklime 3^0 web site which demoastrates how 
you can write components which apply video effects or aikjw 
applications to import images stored in a new kirmat. To round 


things out, there is a 'lechnote desc:ribing how the Component 
Manager handies PowerPC native components. 

Inside Macintosh: More Macintosh Toolbox 

< hup ;//de vwor Id .appi c'com/dcv/tedisupport/ in ^demacyMoreTootMx/MoreToolbox- 2 .htmb 
Inside Macintosh: QuickTime Components 

< h tlp://devwor id .a p p I c co m/dev/tec h b u p por l/i r is i deinac/QTCom pon ents/ 
QTComponents - 2. html> 

QuickTime 3.0 Developer Index 

<http://www. applecom/qurr.kiirTie/prpview/develop/i ndex,htm> 

Component Manager Sample Code 

<ftp://dev.appleLccjm/devvixxld/./Sample_CodeyQukJcrEme/CompcHient_Mana^^ 
QuickTime 3,0 Sample Code 

< h it p ://www. a p pie, com ^ i j i c k T rmey p review/d e ve I o p/s am p I ec od e, ! }i rri i > 

Technote 1004: On QuickTime Component Manager 3>0 & PowerPC Native 
Components 

<lutp://devworld.apple.com/dev/technotes/tn/trT 1004.html> 

Tlic mt>si cxpan.sive example of using a cum|ionent to 
supply services to multiple applicatitjns is Internet Config, the 
source to which is in the public domain. Internet Config has 
become indispen.suble as more and more applic:ations liecome 
internet-sawy, and it's u great example of using a component to 
save programmers from the need to ctKle in the same 
funitionality over and over. Tlie author's ftp site ha.s the source, 
wliich you can use as an example of giKxJ component design, 
and a programmer's kii which show,s you how to use Inrernei 
Config from within your application. Dan Crevier has also written 
fC++, a C++ wrapper class for Internet Cx)nfig, which illustrates 
liow you can make it even easier for you (or others) to call your 
component fnim inside an application, 

Internet Config FTP Site 
<f tp://ftp.quinn, echidna - id .du/Others/Quinn/Conf3g/> 
tC++ Wrapper Class for Internet Config 
<http://www.bofn§o. com/da n/sof (war e/ Progr am mi ng html > 

Using the Internet Configuration System 

<http://www mactech riclos/mactech/Vol-1 P11.04/Internet*Config/te)tl.htnnl> 

Implementing Shared Internet Preferences With internet Config 

<http;//www. mac tPfh.com/jftidos/dCvclop/iSSUe_23/quinn.htrTi1> 
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Photoshop Plug-Ins 

Probably Lhc most wt:i!-known lypt' of application plug-ins 
are Piioioshop plug-ins; in fact, and entire industiy has been 
built around them. You can get in on the fun by downloading 
the Photoshop SDK from Adobe, whk:h also has SDKs for plug¬ 
ins to Llicir otlicr applicatioaSj including Illusirator and Acrofiai. 
There are actually several different ty'^pes of Photoshop plug¬ 
ins—the mast common are filters, which direclly manipulate 
images, but there are also image acquisition plug-ins, which let 
you drives devices such as scanners from within the application, 
and impon and export plug-ins. 

It's possible to support Pholoslujp fdug-ias in your own 
application, and many third parties do this to increase, for 
instance, the image-manipulation power of their applications. 
NTH Image is one example. It is an Image pnK:cssing and 
analysis applkadoii developed by the National Institutes of 
Health and is widely used for scientific imaging. Not only is it 
free, bui its source code is in the public domain. !l supports 
some Photoshop plug-ins, so it can serve as a test bed for those 
developers who want to experiment but don't own Photoshop, 
or who are designing rheir plug-ins for the widest range of 
compatibility. The source code, of course, can help those 
looking to SLipix)!! Photoshop plug-ins in tlieir own application, 
or who want a model for a plug-in archkecrure in general. The 
NIH linage ftp site also has a directory full of plug-ins, some 
with source code, to serve as examples to developers and to 
augment Adobe's SDK, 


Adobe Developers Relations SDICs 

< http://WWW. adobe, tom I ^ uppo rtservice/d evre iations/sdks, h tm l> 

H\H Image Home Page 

< h tt p ://rsb. i nfo. oih.g i h-image/> 

NIH Image Mailing List 

<http ://www. soil s.ag ri. jm n .ed uf ^nf oserv/l ists^nih ^ im age/> 

Last, Bta Ncri' Llas j 

A plug-in architecture is a Good Thing. It can reduce the 
size of your appliartion, decrease its memory fcxitprint, and 
proniolc good design by enccmraging you to factor ytiur 
application into funaionaliy independent pieces and prepare it 
for future enhancements. While implementing a new design 
strategy, it's always gtxid U) have some printed maicriat on hand. 
Plug-ins are code fragments at heart, and the definitive text on 
these is A Fragment of Your Imagination, by Joe Zobkiw. It has 
chapters on the Component Manager and on PlioLoshop filters, 
as well as covering system extensions and most other related 
topics, and there is even an accompanying web site. 

A Fragment of Your Imagmation 
<http;//www.triplesott.com/fragment/> 

These and other links are available from the MacTecfi 
Online web pages at <http://www.maaech.com/online/>, lEl 


Dilbert®' ScoU Adams 



HERE'S m IHTERE5TIN6 
EOITORIRI... 


THIS GUY 5^Y5 WE SHOULD 
IfiCRERSE THE Pf\Y OF 
CONGRESSMEN TO REMOVE 
INCENTIVE FOR THEM TO 
ENGAGE IN ILLEGAL 
ACTS, 


DY THAT THEORY, 
CRIMINALS AREN’T 
BAD, TU5T UNDER¬ 
PAID. 



©1998 Uniled Feature Syndicala, Inc. (NVC) 
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TIPS & 
TIDBITS 


1^ Steve Sisak 


Over the past few months we’ve had a few tip.s submitted 
on how to open a serial port or detect if it is in use. 
Unfortunately, we haven't received one that was sufficiently 
correct or complete to publish as a winner. Since tills seems like 
an interesting topic (and one tliat lots of people get wrong), Tm 
going to try a new format: a terse mini-article with enough 
information to get you started and pointers to more' infonnalion. 

If you like tills f<mnal, liave a good idea for a topic but don't 
know tlie answer, or have other ideas how to make this space 
more useful, please send mail to tps@ni^ecti,cDm. I’ll lx: glad to 
pay the stantlird reward and give you credit for a really good 
c|ucstion (assuming I can find the aaswer and it's generally useful). 

Serial Port TiDBn s 

If you've ever tried to write an application which uses the 
serial port on a Macintosh, youVe probably disc'overed that (1) it 
didn't work on the fifst try^ (2) ihe infomiation on wliat to do was 
.semtered all over tlie [>lace and C3) it still didn't work in all cases. 

In dse you haven't, the information for how m correctly 
open and use the serial drivers is scattered utross inside 
Macintosh, tlie (Communication Totillx^x dtKu menial ion, the AliA 
SDK and various tech notes. Thtfre are also several misleading 
and obsolete descriptioas in Inside Macintosh \^)Ls. hVT. 

'ITie most aiithorilative sources arc Inside Macinlo.sh: 
Devices and Tech note 1119, by (^uinn (The Eskimo!) which 
pulls most of the relevant information together in one place. 

Listing the Serial Ports 

In the lieginning, every Macintash had exacliy 2 serial pc ms 
named “Mtxlem Port” and "Printer Port” and the names of their 
drivers were hard coded — these days Poweri^cxiks often have 
only one port and/or a built-in modem, NiiBus and PCI cards 
make it possible for the user to add ports, and softwaa- creates 
"virtual" ports to make it possible for multiple programs to share 
die same physical port. 

To determine how many ports a machine has and what their 
hiiman-readaiiie name are, you need to use the Comiiiunications 
Re.sourcc Manager (CRM), which is pan of the tbrnmimicadons 
Toollx>x (one of those managers that Apple has declared 
ob.solete, but hasn’t gotten around to replacing yet). 


For each port, the CRM maintains a CRMSeriaiReccxd 
containing the following information: 

typedef sJtruct GRMSerlalRecord I 
short version; 

St rin gHa nd1e inp utU rive rName; 

St ri ti gHand 1 e out putD r i v e rN am e; 

StringHandle name; 

CRMTcoaHandle devicelcoa; 
long ratedSpeed; 

long maxSpeed; 

long reserved: 

J CKMSerialRecorrd* 'CRMSerlalPlr: 

To iterate over the available ports, you use die function 
CRMSeafch(). The following code fragment finds a port by name 

— you can easily adapt it to build a menu, etc.: 

CRMSerialPtr FindPortlnfo{ConstStr255Parairi name) 

I 

CRMRec crraRec; 

CRMRecPtr erm inaiRec; 

// Gel Itie search started 

crmRec .crmDeviceType “ crmSerlalDevice; crraRcc.crmDevicp.ID 

- 0 ; 

while ((erm ” CRMSe^^^c:h(crm)) 3“ nil) 

I 

CRMSerialPlr port Info * 

(CRHSerialPtr) ern >cimAUributos; 

if CEqualString(*porTlnfo->natBe, name* false* true)) 

I 

return port Info; 

I 

I 

return nil: 

I 


OPENINC;, iNn tALlZlNG AND CLOSING A SERIAL PORT 
Tlicrc is a specific sequence of calls you must use to open, 
configure and dose a serral port. It is listeti in laside Macintosh: 
Devices on page 7- It. If you do not make the calls in this order, 
strange things will happen. 


Send as your tips or we’ll install EvenBctterBusEnor on your raadiine! On ihe other hand, we might just pay you $23 for each tip we use, or $50 for Tip tf the 
Month. You can take.ypur award in ^oods, subscriptions or US$. Make sure any code compl&i and send tips (and where to mail your winnings) m ourTips e-ipail 


address at tips®m^a'h.cm : (See:|Sge;^foC Our jothet ayddres.^;.] 
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Macintosh 
Development News 


The site has all the current 
breaking news in the 
development community 
and even archives past 
news pieces. 






Search the Site 


« 

« 


Search and find that 
article, news piece or 
source code you're 
looking for via the new 
Phantom search engine 
courtesy of Maxum. 


Article Archives •** 


w. 


These archives have 
thousands of pages of 
content in them from the 
histories of MacTech, 
MacTutor, develop, and , 
Frameworks magazines. ,*** 


develop .*• 


The entire history of 
develop, Apple's award 
winning technical journal. 
That is 29 issues from 
1990-1997. 


Netscape: MacTeeft Hogozine 
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IffiPOT 
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MacTiiCb CD ROM 
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i Z/02/97 PH ; liBtroviTfca Annoyrsn First Quarter 199B 
Rbvetiuwef U5$6,2 MIlHQh 


12/02/97 PH : WebSTAH PBv*rK*y Pro Tlckl«r 
12/02/97 PR : The Association Of Macintosh Irolners 
1^/01 /97 PH ; Apple AnmuncosWeliObjects 3.S 


12/01/97 PH : Apple Dallver* Public QirickTIrw 3.0 Developer 
Prevlav Rslwsa 


I z/01 /97 PR : Rtnster Ttchfwlogies iInn»sObjectspaca 
Vogagar M Primary Java I nterfaca For Diitrlbuled Cemputi ng 
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Tht‘ .set[utnce *j>: 

1) Open the output driver, tlien the input drivcri always open 
both. 

2) (optional) alloc:ate a buffer larger than the debiult 64-byte 
i^uffer and calf ScrSetBuf. 

3) Set the handshaking mode. 

4) Set the baiKi rate and data format 

5) Read and/or write the desired data, 

6) Call KilllO on both drivers to temiinate any |>ending 10, 

7) Restore the default input buffers. 

H) Close tlie input driver, then tfie output driver. 

DFTRRMINlNCi 1 f A SERIAL DrIVTER IS OPEN 
Detennining if a serial driver is open in use is a little bit 
tricky and a lot of software gets it wrong. The fmjblcm is 
twofold: first, OpenDriverO doesn't Ixjther to check if a driver is 
already open — it just returns noKrr and the reference number 
of die already-open driver If you use it (or worse, ckxse it when 
you're done) Bad Things^" will happen. 

To get around this you mvist walk the device list in low 
inemtjry to see if a driver is already open before trying to open 
it again. 

The following routine finds the index of a driver in the unit 
table (or 4 if it doesn't exist): 

shorL Firidtlrive'rlTidex(ConstStri?f)31:'araiii name 3 

I 

String^Ptr driverName: 
short Index: 

AuxDCEHandle entry: 

AuxUCEHandle* table = CAuxnCFHandlc4 LMGolUTableBaseO : 
short count = JJIGGlUiiiLKtiyCounLtJ; 

for (index = 0: index < count: indeK++) 

( 

if ((entry table [index]) I- nil) 

I 

If C (“entry) ^dCtlFlagf; ft dRAMHasedMask) 

I 

driverMamc ^ 

{“([DRVRncoderllandie) ((“entry} .dCtlDrlver)}) ^drvrNarae: 

I 

elae 

I 

drlverName = 

((DRVRHeaderPtr) (f * ^entry) .dCtlDriver))} .drvrMairie; 

J 

if (EqualString(driverNajneI name, false, true)) 

( 

return index; 

1 

1 


reiurri I; 

I 


To check if a port is open, we can write: 

Boolean IsDriverOpen(ConstStr255Paraiii narac) 

1 

short Index = FlndUrlverlndexlnatne): 

if (index >= 0) 

I 

AuxDCEHandle dee = 


([AuxDCEHandle*) LMGetUTabieBaee ()) [index] ; 

if ((“dee) .dCtlFlags S: dOpenedKask) 
f 

return true: 

} 

1 

ret urn false: 

^ llotei LMSetUTableSa^O is missing ^rresome yersipti^ ’ r 
*! may have tO'^mpl^‘fnerit ft. ! 

^ ^ * r-. ^ ^ ^ ^ ^ i H. fi <4 ^ .V- C j. « - y i- » ^ 

; ycftMsdtw usc^riieweBk^^ y j 

1 

Now for the second half of the problem — the Serial Port 
Arbitrator, included with the Appletalk Remote Access server 
and other software allows a port to be opened "passively" 
meaning that a server may have a the port open to look for 
an incoming call, but will fclinquisli it if another applicalion 
wants to use it. 

In this ease OpeoDriver will return portlnllse (-97) if the 
driver is oixm or noErr if it is not. (in eklicr case, it will return a 
valid refNum). However, softw'are which walks the device table 
will incorrectly rhlnk Thar the driver is open imd report an error. 

The correct procedure here Is to use (lesiali to determine if 
tlie Serial Port AriDitiator is present and, if it Ls, tlien just call 
OpenDriverO, otherwise, walk the Unit Table: 

Boolean HaveSerialPortArbitration(void) 

I 

long result: 

OSErr err; 

eir “ Gestalt(geHtaltArbitorAttr, ^result): 

return (err noErr) && (result & (1 « 
gestaltSerialArbitrationKxi^ta)}: 

] 

OSErr OpenSerlalDrl ver{GanslSi ir2S5Paru]ii narac, short * refNum) 

I 

if (I lluveSetiniFortArbitration0 ) 

( 

short index = PindDriverIridex(name3; 

if (index 0) // Driver i*) ^ilrr^idv aptn 

I 

*rofNuiii = H.ndGX; 
ruLurn porllnUse; 

1 

I 

return Openflrivec(naine, refNum); 

J 


Reading from a 8f.riai. Port 

You can read from a serial port just like a file by using 
PBRead or FSRead, however you can't seek and if you try to 
read more bytes are actually available, you will hang the 
tnaeiiinc in SyncWait() until the number of byte.s you requested 
is actually available. 

To avoid this, you can make a status call to the input driver 
with cisCode = 2 to find out how many bytes are available in the 
drivers buffer and iJien only request that many l>ytes. 
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0)RRE<Tii)N TO May Tip — Wrapper for ParamI^fjct 
The tip ""Wrapper for FaramText'' incorrectly states that one 
cannot pass nil ai^imeriLs to ParamTextO. In fact, ParamTextO has 
always accepted nil arguments, and leaves the corresponding 
parameters unchanged. 

1 use this feature fret^uenUy in order to conserve stack 
space. I can set all 1 parameters using only one Str255, as long 
a,s 1 do it otie at a time. 

Actually, tliis example only .sees 3 pamins: 

void 

ReportEirror ( short doinglx. const char 'what ) 

I 

Str255 fltr: 

if( spareMeii ) 

Dispos^llattdle E spctrcHcm ): 
spareMem * 

CtoPstrepyt str, t const unsigned ciiEir *)whal., slzeof str 

): 

FaramTextt str, ftULL, HULL 

GetErrString( doinglx, str ): 

PeraniTextt NULL, sir, HHTjL, HULL ): 

P Eww. Uui I don't liavc to PiramTcxt menn item text every command, 
which might slow iliings down if we re heing scripted. 

7 

ir£ doingTx ” dolngMenuCnid ) I 
str[0l = 0; 
il't tg-dolnglteiu } 

GetID( tg.doingltevj, str ); 

ParaniText( NULL* NULL. NULL, str ): 

1 

else ifC doinglx = doingHentiAct ) t 
sir[0] - 0; 

IfC tg.doiiigltciti && tg.doingHenu ) 

CerHenuIteiiiTexc( GctHenu(Tg,doing^enu), tg.doingltnia. Str ); 
Paramrextt NULL. NULL. NUU. str ): 

) 

VerlfyAlert{ Ur4 ); 

InilCursort); 

StopAlcrit 144* DefsultFilter )* 


Tony Nelson 
tonyn^tiac.net 

tD 
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Imaging, Annotation & Plug-in 
Development Tools 

RasterMaster 7.0 Powerful, multi-platform raster 
imaging support for 60+ Raster Formats. Familiar API and 
wall-proven technology in use worldwide by companies 
such as BP, Chase Manhattan. Ford, Gannett HP, IMSI. Kodak, 
LEXIS-NEXIS, Polaroid, Toyo, Unisys, Xerox and more. 
Formats: TIF, JPEG. MG DCA, CALS, PNG, DICOM, Flashpix, 
BMP, BRK, G3, G4, GIF, JED, KFX, MAC, IOC A, PCX, IGA, 

WFX and more. Features include: (* New for Veraion 7) 

• Compression * CMYK 4 Plane Support * 

- Image Processing *10-16 bit Gray ScaleJ* 

• Despeckle & Deskew • Anti-Aliasing in Silver * 

• Muttipage TWAIN Scanning * Fil to Widdi & Height * 

- Pan, Zoom, Scroll 
-1 msige Editing 

• Auto Aspect Ratio 

• Alpha Chanr>el Support * 

ItasterNote 2,0Annotation/Redlining toolkit Features 
ihGlude: SUcky Notes, Lines, Ellipses, Freehand Drawing, 
Polygons, Highlighting. Redaction, Multiple Annotation layers. 

Rast^TlNet 2.0 Rug-tn for Netscape and Internet Explorer. 
Read 60+ Raster Formats! Simple drop In library makes it easy to 
enable standard browsot^ to read your Intemet/lnlranet pages, i jj 
Ptatfbrms Include: Win 95/NX tAln Mac 83K/PPC, UNIX Alphi^ 
Languages: 'DLLi VBX, AclivsX/dCX, Delphi, FpxPrd, 

. . Call 617*630'*9495 Or Visit Us 


»Tiled Image Support * 

* Medical Imaging 

* Animated GIF * 

* Image Encryption ^ & mwe 


JBCL Java Business Chart Library 





• loo'll Fure Java 

• Java Beans enabled 

• Interacthv property editing 

• Export to GIF and JPEG 

• Powetful API 

• Multidimensional statistics 

• With Java Query Library 
for easy I)B-Access 


Want to share a tip with the 
community and get paid for it? 
Send it in to 

<mailto:tips@mactech.com> 


Only $395! 

Dowtjload our demo today! 
http://WWW. advanced, ch 

Java and C'* libraries and Frametvorks for Programmers 



bttpJIunpiraduatKedch * $ales>fadmnce<tch 

AduancedCottce^Mi * HOmerMstrusie i * QUeH'KjOerthur • Smitzertmd 
Phone: +41522450245 • ftuc. +42522450246 
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NEWSBITS 


hy Jessica Courtney 


Sonnet Technologies ase Fikst to Ship PowerPC G3 
Processor Upgrade Cards for PowFja Macs 

New line of PowerPC 750 (G5) Processor Upgrade Cards for 
Power Mac (6l00, 7100, 8100)Workgroup Server (6150, 8150, 
9150), Performa 611 x and Radius 81/110 began shipping. 

Sonnei Technologies, the leading manufacturer of 
performance upgrade products for Apple Macintosh eornpuLcrs, 
today began shipping three new models of PowerPC G3 (750) 
processor upgrade cards for first generation (Nu-Bus) Power 
Macintosh Computers, The new Crescendo G5 line is available in 
the following configurations: 

* Crescendo G3 -215-225 MHz with 512k backside cache at 
2:1 ratio. 

* Crescendo G3 -240-250 MHz with 1MB backside cache at 
2:1 ratio. 

Universal Upgrade Cards with Optional Adapter Kit for PDS 
AV or Video Pass-1'hroiigh Both Crescendo G3 upgrade caal 
have been designed to be universally compatible with all of the 
following Macintosli rntMlels: 

* Power Macintosh 6100, 7100, 8100 

* Performa 6ll0, 6112, 6115, 6ll6, 6117, 6118 

* Workgroup Server 6150, 8150 

* Radius 81/TlO. 

For PowerMacintosh 7100 and 8100, an optional adapter kii 
allows existing high-speed VRAM video cards or AV video cards 
to attach to the Crescendtj G3 through a pa.ss-through connection 
built into each card. With the adapter kit the video card will 
occupy one NuBiis slot space. 

<http://www.sonnettech.com>. 

Omikron Basic 6 is Now Available for the PowERMAt: 
lliLS programming language, favored by scientists and 
engineers l:>ecaose of its extensive repertoire of mailiemaLicai 
funeiians is now finally available for PowerMacintosh 
computers. Tlie use of Omikron Basic 6 enables direct utilization 
of the enormous computation power of the Power PC prtx:es.sor. 
Worth mentioning in this context is Omikron Basic’s extremely 
fast operating dynamic string management, which doesn’t 
require prior dimensioning. Programming with Omikron 6 is as 
easy as one expects from a BASIC programming language: 
Simply open a new programming window, type in tlie desired 
programming code, compile with one moose dick, and you can 
start the program at once. 


The Omikr{)n Basie programmer can anticipate working 
with an intelligent editor widi many well thought out features, 
the simultaneous syntax check when entering programming 
code is just one feature of many. The EasyGem Library enables 
the creation of surfaces typical of the Mac environment. Even 
beginners will have no problems due to the extensive 
d<x:umentat[on delivered with the program. A UTE Version and 
price discounts for students are offered as well. 
<http://wvvw.omilcTon.net/basic/main_.e,htm> 

ObjectPlant 1,5-1 

ObjeetPiant is the only shareware Object-Oriented 
Analysis/Design tool for Macintosh. Jl supports OMT and a 
subset of the UML notation. It is also capable of generating 
C++ and Java code. 

The 1.5d version indudes some new features but is mainly 
a maintenance release. 

<http://www.softsys,se/Objed:PlBnt/> 

Media Di-sign in^ProgriiSS Releases l^rrERAcnoN 2,0 — 
Dynamic Adaptive Web Sites whh Server-Side XML 

Media Design in*Progress released the 2.t) version of 
Interaction, the web server companion for dynamic social 
websites iluU adapts to tlie vi.sitor. Interaction is the first 
application to take advantage of server-side XML 1.0 for dynamic- 
websites. llie software works with Mac OS Web servers, 
generating HTML on the lly from XML dcx umenLs. 

Inteiaetion allows professional webmasters to benefit from 
the efficiency and flexibility of extensible markup for developing 
and maintaining today's websites. The application provides 
wizards to create, insfKXt and modify exiensible markup, 
liberating the author from detailed knowledge of the XML 
spedfieaiion. Using Interaction, webmasters and authors can 
create and use tlieir own custom XML elemenLs (tags), XML 
entities (indudes ) and specialized XML dcKument types (markup 
languages) wfien eonstmciing the website.s. 

Inieraetion generates HTML pages at serving time from XML 
documents, based on the processing rules of a style sheet and 
the context of the request. 1’he result is website^s that adapt to 
each visitor without requiring scripting, programming or 
proprietary “command tag” constaicts. The integrated Cascading 
Style Sheets (CSS) editor simplifies designing and maintaining a 
c:onsistent presentation of the website. Interaction can optionally 
emulate CSS to keep the site.s accessible and appealing for tliose 
using older browsers, 

<http://inter3aion.in-progresS-com> 


64 


NewsBits 


MacT'ech • June 1998 












Apple’s New HyperCard 2.4 Now Aymiable; The Ijitest 
Version of HypERC^ARO Leverages Powerrti 
QuickTime 3 Capabilities 

Apple Computer, Inc. tcxlay announced the avaibbilify of 
Hyfx.‘rCard 2.4, the latest version of the Company's custom 
software development tool used to create interactive 
applications primarily for iraining and education. HyperCard 2.4 
leverages QuickTime 3's rich array of video and audio 
capabilities, making tt pos,sihle to easily add sophisiicated 
multimedia experiences to existing or new applications Building 
on the fK>wer of QuickTime 3* HyperCard 2.4 lets users work 
directly with more than 30 standard media file types. 

HyperCard 2.4's new features include a suite of 
commands and properties, offering users who write HyperTalk 
scripts the ability to: establish links from HyperCard slacks to 
QuickTime movies, QuickTime VR scenes, and the World 
Wide Web; navigate quickly to predefined locations in a 
QuickTime movie by searching the movie's text track; resize, 
flip, mirror, rotate or skew a QuickTime movie in real time; 
l(x>p a movie, providing continuous play for unattended 
applications like multimedia kiosks. 

Ab<iut HyperCard 

HyperCard is Apple's custom software development Uk> 1 for 
users of every skill level wiiti navigation, hypertext, media 
integration and scripting features that have greatly influenced the 
evolution of the World Wide Web. HyperCard organizes 
information into associated "stacks" of cards iliat can be easily 
navigated and searched. Users arc able to integrate and link text, 
graphics, sound, speech and Quick'i ime movies into HyperCard 
stacks to create dynamic, interactive titles. 
<http://www.apple.com/qulcklime/> 

Wavers in Motion Releases Analyzer 1,0 por FileMaker 

New development tool thoroughly documents and 
analyzes FileMaker projects. 

Ask a room full of FileMaker developers what they like 
least about their job, and most will tell you it's the prospect 
of making changes to projects with hundreds or even 
thousands of elements, wlierc something as simple as 
deleting a single field can affect any number of layouts, 
calculations, relationships, and scripts. 

Depending on their needs, developers can use tlie Analyzer 
generate summarized or detailed projea reports. To choose one 
example: the detailed report for a particular Reid incriudes a list of 
all the layouts that include the Reid, every stxipt that u.scs die field, 
every relationship tiiai refemnees the field, and evejy calctdaiion 
tliat requires a value from that field. Analyzer indicates the type for 
each field, if a field is indexed or not, and die numlw of 
repetitions for each field. For calculation fields, Analyzer displays 
die calculation and the field type mtumed by the cilculaiion. 


All tills is information thoroughly cross-referenced in its 
own FileMaker database. Tlie svnpi report for each field, for 
example, includes a list of each script that uses that field, wliile 
the report for each script contains a complete list of ilie fields 
included in that script. 

With this kind of detail, clc*urty structured and cataloged in 
a series of simple layouts, it's also quick and easy to search for 
pretty much anything, by the name of an element or for a 
particular string within the cleinenLs, You can, for iastance, 
search through all the scripts in a project for nutdated 
procedures or elements that no longer exist. 

Or you can use the ick>Is built into the Analyzer to trace the 
lx:havior of your FileMaker scripts. Click on a reference to an 
external script, and the Analyzer instantly shows you llial script 
Move through the script .step by step, or lei the Analyzer trace 
through an entire script for you and l>uild a hierarchical report 
o(' every instruction, eveiy external script, and every recursion. 
These trace reports are color-coded, and the .structure is 
collapsible to help you iKtler see just what is going on. 
<http;//www.vvmotion.com/produds.html^ 

Maxum Development Announces MaxumPack Pro Bundle 

Maxum Development Corporation announces the release* of 
the MaxumFack Pro, a software bundle that includes M;ixum’s 
most popular Inrernel server devclopnient tools. At tlie same 
time, the .standard MaxumPack has lieen streamlinetl and is now 
offered at a reduced price. 

Maxum initiared the Internet server toots category more 
than three years ago. Since that time, Maxum pnxlutTs have 
Ix'cn used by a wide range of Web developers, from building 
small departmental Intranets to creating full-service commercial 
on-line services. To meet the needs of the broad range of 
dcvclo|>ers, many of Maxum's products have recently !>cen 
introduced in “Stanckird" and Trofe.ssionaP versions. 

Both PageSentry and Rumpus, for example, are offered in 
Standard and Pro packages, but all of the features in the Pro 
versions are also built into the Standard packiiges. PageSentry 
Stanebrd .supports up to 10 Sentries and 10 Notifiers, while the 
Pro version permits up to 100 of each. Similarly, Rumpu.s 
Standard allows up to 32 simultaneous conneciions and 32 
built-in u.ser accounLs, with the Pro version supporting up to 
255 concurrent users and user accounts limited only by 
available RAM. In all other respects, the Standard and Pro 
versions of these products are identical. 
<http://www.m3xumxom/> 
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Stauker Software Announces Staxxer Internet Mail 
Server 1-6 

Key features: New Blacklistifig (RBL) tmplementatioft, 
support for mobile users, still FREE 

Since liie first free pul:i]ic fclca.se of Stalker's Iniernct Mail 
Server, it has teen consistentiy upgraded with new performance 
enhancemenns. The most recent piii>lic version to be released 
1.6, offers the latest technologies for mail servers mciuding anii- 
spam features and better administrative additions. 

IP [blacklisting has been proven to be the most efficient way 
U) cut Lmsoliciied E-mail (“spam”) mes,sages: mail servers with IP 
blacklisting implemented rejects all messages that come from 
known offenders. However, spammers may change their 
providers and IF :idrlre.s.ses, and new spammers appear every 
week. This makes tlie job of kec[>ing die lilack List current an 
everyday duty for mail server administrators. 

Tile DNS'hased blacklisting is a new emerging technology that 
automates tliis task. A regular DNS server Itxiated anywliere on the 
Net can te used io keep die IP addresses of all known spammers. 
Ihe anti-spam warriors inform tlie administrator of the black-listing 
server alK)ul unsolicited E-mail llieir useis have received, so that the 
server has an up-to-date list of known offenders. 

With the 1.6 version of SIMS, the name of a blackdisiing 
.server can be entered in the SMIT mcKlule settings. When SIMS 
receives mail from a remote liost, it checks not only iis own 
black list, hut also consults the black- listing server, too. If the 
sending hosi is included in the blacklisting DNS server tables, 
inessages from tliai host are not act:eplcd. The entire prrK:ess i.s 
automatic and allows all mail server administrators to centralize 
and to distribute their knowledge about offending sites, Sinc'e 
the Idacklisting servers are imfilemenled using the existing DNS 
technology and software, several servers arc already available on 
the Net, and they can be used with any SIMS i.6 mail serve^r 
One of the first anti-spam feat tires implemenied in SIMS 
was protection from unauthorized mail relaying. SIMS could 
relay a message to any internet site only if it was ,sent from a 
known (usually - LAN) FF addre.ss. This feature did nta allow 
spammers to aliuse a SIMS server, ]>ut it also creaied prol>lems 
for mobile users that connected to the Internet via various 
providers, and thus u.sed various IP addresses, The.se mobile 
clients could use SIMS as dieir "^SMTP serverf With the 
version 1,6 thi.s problem is addressed in two ways. 

First, the so called “XTND XMl'f” extension is implemented 
in the POP module, Ii allows remote u.sers to sttbmir me,ssage.s 
via tlie POP, not SMTI^ piotfxrol, and the POP3 protocol 
authenticated users using passwords, not IP addresses. Eudora 
and some other mailers support this POP protocxil extension. 
Second, the POP iikkIuIc records ihc client 11^ address when 
it authenticates a user. During the next minute, messages from tliat 
II* arldreics are proc:essed as messages from the known (LAN) 
clients. When jemote users clieek llieir mail on tire SIMS server 


(tills results in user aiitlientioition), tlieii' IP addresses are recorded. 
Then they submit messages to the server via the tegular SMIP 
prot<x:ol. Since tfie mes^sages come from ihe authentk'aled 
addresses, they are marked as such and can be relayed anywhere. 

Along with the new Anti-spam features, SIMS has been 
Lgxlaied wiiFi several enhancements for Administratt>rs, tlius 
allowing for easier monitoring of the server. Hie SIMS logs now 
receives a Eailure (Level-1) record wlien the SMTP module rejects 
a relLim-path or a recipient address, and a when liie POP or PWD 
module rejecLs a user name/[>assword: this feature allows 
administrators to detecT when their systems are under attack. 
<http://www.stalker.com/SIMS/> 

Macromedia Introduces Dreamweaver 1.2 

Visual Web Authoring Tool Now Compatible with 3-0 and 
4,0 Browsers to Deliver High-Impact Web Pages over Low- 
Randwidth Internet Connections 

Macromedia ann{}unccd a new release of Dreamweaver, Uie 
leading visual tool for professional Web site design. 
Dreamweaver 1.2 enahle.s web developers to deploy high- 
impatl web pages over low-bandwidth Internet connections that 
rake advantage of advanced Dynamic HT'ML rcalurc.s for users of 
4.0 browsers, while maintaining compatibility with 3-0 browsers, 
Tliis new release also includes several new' enhancements that 
improve wcT) developer pRxluciiviiy and enhance ease of use. 

Macromedia also announced that the recommended retail 
price of Dreamweaver 1.2 will remain at $299 US, the same as 
the iniR^ductory firice for Dreamweaver TO. A 30-day trial 
version of Dreamweaver 1.2 i.s now availalile for download at no 
charge and all current Dreamweaver 1,0 customers can 
download a free Dreamweaver 1.2 updater. 
<http://www.dfeamweaver.cam> 

SixyrCuLCK 1-1 

CenieWorks, LLC would like to anncjunce our first general 
beta release of SpotCheck Tl, with full .support for the Java 1.1.x 
language and APIs. 

^Sp<aCheck is a Ianguage-ba,scd editor that ‘"knows” tlicjava 
language. It is designed to hel[i a Java programmer produce 
correct ccxie without relying on confusing and untimely 
feedback from a t:ompiler. 

Specifically, SpotChcck identifies syntax errors and semantic 
errors (undefined names, type mismatches, etc.) - those errors 
normally returned by a compiler. This analysis is performed after 
each edit, giving the programmer immediate feedback on errors. 
<http://www,genieworks,c(}m/>. 
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If you want to be in the know, then you 
need every article published in the first 
12 years of MacTech® Magazine and 
Apple’s develop” issues 1-29! 


in THINK Reference^^fonnat! 


So hurry, pick up the phone, fire up 
the e-mail, launch that fax machine, 
or simply drop by our web site and 
order yourself this new release of 
the MacTech* CD-ROM. 


Almost 1600 articles from all 139 issues of 
MacTech Magazine (1984-1996) 

Includes Apple develop issues 1-29 

Improved hypertext, improved indices, and a new THINK 
Reference Viewer — for Ughtning quick access! 



New hyperlinks between articles 

100-1- MB of source code — use them in your applications, with no royalties! 

Full version of THINK Reference — the original online guide to Inside 
Macintosh, Vols. I-Vl 

80MB of FnimeWorks/SFA archives and the most complete set of Frameworks 
archives known 


Sprocket™! MacTech's tiny framework that compiles quickly and supports 
System 7.5 features 

Tlie best threads from the Mac programmer newsgroups plus thousands 
of notes, tips, snippets, and gotchas 

Popular tools that Mac programmers use to increase their productivity and 
much more! 



Web Site: http//www.devdepot.com • E-mail: orders®devdepot.com 

Phone: 800-MACDKV-1 • Outside the U.S. & Canada: 805494-9797 • Fax: 805-494-9798 


MacTech is a negislerod trademark of Xplain Corporation. MacDev-l, THIISiK Reference, Developer Depot, Sprocket, JavaTech, WebTech, BeTech, and the MacTutorMan 
are trademarks of Xplain Corporation. Olher trade marks and copyrights appearing in this printing or software remain the properly of their respective holders. 








THE 

CLASSIFIEDS 


SERVICES 

in .... 


The Law Office of Bradley M. Sniderman 

California Lawyer focusing on Intellectual Property, 
Corporate, Commercial and Contract law, as well as 
Wills and Trusts. 

If you are looking to protect your software with 
Copyright or Trademark protection, or if you need help 
establishing or maintaining your business, please give 
me a call or an e-mail. Reasonable fees. 

(310) 553-4054 

brad@sniderman.com 


Visit MacTech* Maine’s Web site! 

http://www.nnactech.com 



Professional Software Developers 


LooMng for career opportunities? 

^ Check out our website! 
r Nationwide Service 
Employment Assistance 
Resume Help 
Marfcetabil ity Assessment 
Never a fee 

Scientific Placement, Inc. 

800-231 -5920 800-757-9003 (Fax) 

das @scientific.coni 



Wan 


move? 


r Depot! 


The fastest, cost effective way to get product off your shelves. 

For informalion: • Voice: 805/494-9797 • Fax: 805/494-9798 • E-mail: vendor_relations@clevdepot.com 
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You’ll be stuck in the 
heaviest traffic in New York City 
and loving every minute of it. 


This year at Mjicworld Expo, Apple is going to make it easier for all developers, big and small, 
to get a space as special as their ideas. Apple Computer and Maclhch Ma^zine 
present “Developer Central”'an exhibit at Macworld that showcases development for the 
Macintosh* in the biggest possible way Macworld will be held in New York City, 

July 8-10,1998. For infomiation on howto participate, check out the Exhibitor Infonnation: 

www.devcentral.com 



Think different: 
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World r^nownedl 
customer Service 


Hiliidreds of 
developer products 

Sptbfactioii 
and lowest price 
guaranteed 


Order by phone, 
E-mail, fax Or through 
our continually 
updated Web site 
















Developer To Do List; 

gfpriorirtxe project list * 

□ Pick up ne^ MacTech C - 

^ ike Dev Depot specials 

□ Check out all tte ^ 

□ Tell the 9""9 „rilHies 

□ Stock up on the lotes 

□ Enter Dev D-PO* ■"*» 


Developer Depot 

PO Box 5200 01 - 45 Q- 

Westlake Village, CA 91359 


5200 


Voice: ro5/494-9797 

Outside us/Canada: 805/494 v/ 

Fax* 805/494-9798 

E^maa: orders@devdepot com 

http;//vrvvw.devdepot.com 
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Order Tell-free 
800-MACDEV-1 




Dtfveloper Depot 30 day Money Back, Price and 
Satisfactioo Gnarantcc 

Developer DeptH products are so^Id with a 30 Day money back |:^arantee on 
user Sivtisfoction, lower prices and against defects. If, for any reason, you arc 
not satisfied or find the same prtxluci at a lower price witliin 30 days, please 
call Custcaiier Service at 800 MACDEV-1 and request a Return Merchandise 
Authorisation (RMA) number to gel a full refund ot the difference in price 
(where applicable), You nri^st return undamageil pnxluct at your expense, 
including all its original packaging, dtxuinerLiatitm and ilie blank waminiy 


card if appliaible. Developer Depot will replace defective product upon 
ret'eipL of the defective mercliandLse. Please rememljer to back up your data 
l>efore installation of any new liardware, sr^hwafe, or pt;ripherals; wtj cannot 
Ix! rt'spfrnsible for any lost data. Pf>Ueies, item availability, and prices are sub¬ 
ject to change without notice. The price in effect when we receive your order 
wi!t he the price that you are charged. We are not responsible for any typo¬ 
graphical emjis tn tills or any other catalog, nor for any misstatements frewn 
any vendor. Purchase ordei^s are not at:cq7led wiUioul prior apfirTOval. Call Ibr 
iiiore inforination 


SLuff our liwyer imde us write. 

Developer Depot makes no other warranties. Alt <ither warramies, either expressed or itnplietl, incktdmg I tie Implied warranty of rtien lismiatiiliiy and firness foi a panieubf purpose 
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j CodeWarrior for 
I PalmOS 
Release 4 

by Metrowerks 

CodeWarrior for Palm OS 
is a complete set of tools 
which enables you to 
develop code for the 
3Com” PaImPilot 
connected organizer and 
the IBM WorkPad from the ease and comfort of your Windows® 
95/NT® or Mac® OS computer. Alt the tools you need are 
included: the award-winning CodeWarrior IDE, compiler, linker, 
source-level debugger, GUI builder plus Conduit SDK for creating 
applications which synchronize between a desktop PC and Palm 
OS, Also includes online documentation, tutorials, sample 
source code, plus one free update and one year free technical 
support with registration. 

(SCWPALM) Our Price $369 



Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 



CodeWarrior 
Latitude 

by Metrowerks 

Don't throw away the 
investment you have made 
in your Mac OS application! 

With the new DR2 release 
of CodeWarrior Latitude, you 
can now port your Mac OS 
application to Rhapsody, as 
well as Silicon Graphics IRIX 
and Sun Solaris. 

At the heart of Latitude is a set of shared libraries which performs 
fhe functions of the Macintosh API. You recompile your Mac OS 
source code, linking it with bie Latitude libraries to produce a 
native application, As the Rhapsody API evolves, so will Latitude. 
Registered users of CodeWarrior Latitude will receive all developer 
releases, the first full release, plus one additional product update, 
to ensure that you have access to the most up-to-date Rhapsody 
porting tools available. 

(SCWLAT) Our Price $399 


Be 

OS 


CodeWarrior 
for BeOS 3 

by Metrowerks 



• Start programming for the new, innovative Be Operating 
System (BeOS) with complete set of Codewarrior tools 

• BeOS-native Integrated Development Environment (IDE) with all 
the familiar CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax color 
and styling, and a source-level debugger 

• BeOS header and libraries, complete documentation, useful 
C++ classes, and sample code 

• Now includes Java support 

• The BeOS Preview Release allows you to run and program for 
the BeOS on a 603 or 604 PCI based PowerMac 

(SCWFB) Our Price $299 



Release 5 

by Metrowerks 

• Source code control 
system, plug-in to the 
CodeWarrior IDE or stand¬ 
alone Client application 

• Compatible with Microsoft Visual SourceSafe version 

• Cross-platfomi support (Mac, Windows, UNIX) 

• Configuration management in excess of 4 billion flies 

• Over B,000 files and sub-projects in a single sub-project 

• Registered users receive one year of free technical support 
and one free update 

(SMWVSS) Our Price $499 
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CodeWarrior 
Discover 
Programming 

by Metrowerks 

Whether you've never 
programmed before or 
you simpiy want to 
learn a new language, 

C, C++, Java and Pascal, this edition of CodeWarrior is 
designed for you. The Discover Programming Edition contains 
the award-winning integrated Development Environment (IDE) 
found in CodeWarrior Professional, and also includes online 
books, online tutorials, and megabytes of sample code to help 
get you started. And with your registration you also get a year 
of free technical support. 

(SDPED) Our Price $79 



Pro Fortran 

by Absoft Corporation 

tosofi Pro Fortran combines native F90, VAX compatible F77, and 
C/C++ compilers into a single, easy to use environment. Ail compilers 
are link compatible and operate through a common interface, 

• Graphical debugger, browsers, array display, performance profiler, 
tinker, MRWE application mainframe 

• MIG graphics library, Absoft Create Make, several utilities, the 
latest version of MPW and illustrated documentation 

• Whole array operations, modules, interface blocks, and user- 
defined types or data sti'uctures 

• Dynamic memory allocation and new control constructs 

• F90 is link compatible with Absoft F77, C++, MrC and CodeWarrior 

• It is fully compatibie with Toolbox, MPW tools, and most third- 
party products 

(SAPROF) Our Price $899 
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CodeWarrior 
Professional Release 3 

by Metrowerks 

More platforms, more languages, 
more options: CodeWarrior 
Professional is designed to give you 
the tools you need for serious, 
industrial strength programming. CodeWarrior Professional Is the 
only integrated Development Environment in which you can edit, 
compile, debug C, C++, Java and Pascal programs for multiple 
target processors and operating systems. CodeWarrior compilers 
produce fast, highly optimized code for Mac OS running on 68K 
PowerPC computers, or Windows 95/IVT running on x86 
computers. One free update and free world-class technical 
support for one year with registration New in this Release: 

• Seamless integration of the Debugger into the IDE 

• Support for AMD-3D Technology 

• Support for Visual SourceSafe' 5.0 API (Windows) 

• Significant improvements on Java tools 

• Tool to compare two folders, see difference graphically and 
merge changes 

(SCWPRO) Our Price $449 



BeOS Preview 
Release 2 

by Be, Inc. 

As the Internet spreads and 
electronic media becomes more 
prevalent, the high-performance 
needs of digital content design and 
the complex, aging architectures of 
current mainstream operating 
systems are coming into conflict. The BeOS is the first operating 
system designed to unlock the door to much more powerful 
personal computers, and extract more performance from the 
systems we use today. 

(SBEOS) Our Price $49 




Macintosh Common Usp 4.0 

by Digitool, Inc. 

Macintosh Common Lisp provides users 
with a rich set of object-oriented dynamic 
language features making it especially 
well-suited for rapid prototyping, custom 
development for business and education, 
scientific and engineering applications, 
and academic research. 


• Power PC native environment & compiler, full Macintosh support 

• CLOS, the standard Common Lisp object system 

• Interactive dynamic environment, multipie processes 

• Automatic memory management and self-typing data 

• Ephemeral gartage collector, smaller application footprint 

• Compiles with Common Lisp industry standard and smart 
programmable tools, 110+ mb of user contributed code 

• Complete on-line documentation (manual sold sep^ately) 

• Software license and registration card 
(SMCUSP) Our Price $675 
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Visual Cafe for Java 
Professional 
Development Edition 

by Symantec 

• Powerful Java and JavaBeans IDE 
with Plug-and-Play JavaBeans 
functionality 

100+ Professional, Reusable JavaBeans Components with 
Source Code 

Full JDK 1.1 Support via MRJ 2.0 
Latest Java Foundation Class (JFC) Library 
Comprehensive source editor with color coding and keyword 
highlighting 

On-the-fly Class reusability 

Turn Auto Code Generation On/Off Environment (RRAD On/Off) 
Powerful debugging Tools including debugging in any 
application mnning MRJ 2.0 and breakpoint view 
Netscape communicator 4.0 
Full featured Visual Page FtTML Authoring Tool 
(SVCJAVA) Our Price $299 





MkUnux: Microkernel Linux 
for the Power Macintosh 

by Prime Time Freeware 

MkLinux is a native port of Mach 3 and the 
Linux 2.0 kernel, complemented by 
hundreds of commands from BSD, GNU, and 
X11. ft mns on most (NuBus and PCI bus) 
Power Macintosh systems; Pertorma, 
PowerBook, and multiprocessor ports are currently under development. 
MkLinux is robust, powerful, freely distributable, and source code 
compatible with most other Linux systems. It provides a full suite of 
development tools, support for AppleTalk. NFS. and Objective-C, and 
access to a vast amount of free software. MkLinux is a great way to 
"come up to speed" on Mach, UNIX, and Rhapsody. 

• MkLinux user community supports FTP and web servers, 
development and porting efforts, and several mailing lists 

• The Apple sponsored reference release contains a wealth of 
introductory and reference material on Linux, Mach, NeXT, and the 
Power Macintosh 

• Includes free 3.0 upgrade 
(BMKLINUX) Our Price $49 


Order Toll-free 
800-MACDEV.1 


I800622-3381I 


Visual Cafe for Java 
Database 

Development Edition 

by Symantec 

• RIeMaker Pro and BlueWorld Lasso 
trialware versions 

• 100+ Database aware JavaBeans 
Sybase SQL 

• Anywhere server-side database with development and runtime 
engines for Win95/NT 

• DbANYWHERE server-side server 100% JDBC middleware 
with native drivers for Informix. Sybase. Oracle and Microsoft 
SQL server 

• Support for over 30+ databases through ODBC 

• Swift and scalable data access with dbANYWHERE's true three 
tier architecture 

• Netscape Fast Track Web Server (Win 95) 

• Netscape Communicator 4.0 
(SVCJDB) Our Price $499 
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VIP-BASIC: 

Visual Interactive 
Programming in BASIC 

by Mainstay 

Now you can create full-featured, stand-alone 

Macintosh and Power Macintosh applications in standard BASIC code! 

VIP-BASIC 2,0 is the fastest way to program your Macintosh. 

• Rapid application development environment with application 
framework, mix and match: VIP-BASIC high-level subprograms 

• Import pre-existing BASIC code: automatically integrate BASIC 
code, export C Code for compiling: automatically convert your 
BASIC code to C for compilation with Melrowerks' CodeWarrior 
(SVIPBASIC) 0urPrice$195 


1 VIP-C: 

Visual Interactive 
Programming in C 

by Mainstay 

Now you can create full-featured, stand-alone 
Macintosh and Power Macintosh applications in just minutes. VIP-C 
2.0 is the Rrst rapid application development system for creating 
complete Macintosh programs in standard ANSI C. 

• Indudes powerful, tightly integrated visual debugger. Import pre¬ 
existing C code; automatically integrate C code with a current project 

• Includes full-featured mini database; (ltd to 32K) of the powerful 
VIP-BASIC database manager gives you everything you need to 
setup royalty-free, multi-user database applications 

(SVIPC) Our Price $295 
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ObjectMaster 
Professional Edition 

by Altura Software, Inc. 

Object Master is an innovative programming environment that 
provides ail the necessary tools to write, organize, and navigate 
through source code. 

• Write code using the most robust source code editor available 
on the desktop 

• Organize source code into projects to quickly arcess and 
manipulate all files 

• Navigate through source code using Intuitive graphical 
Browser windows 

(SOMPE) Our Price $399 


CodeBuilder 

by Tenon Intersystems 

CodeBuilder is a powerful and unique Macintosh software 
development tool for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C, C++, 
Objective-C, Java, Ada, and Fortran development tools 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C, C++, Ada 95 and Fortran 77 

• Web & internet scripting tools: Pert, MacPerl, tcl/tk, bash. sh. and csh 
■ Supports Rhapsody kernel APIs and Rhapsody TCP sockets 

(SMtOCODEB) Our Price $149 


Check out our Web site! 

Full product descriptions • Hundreds of more products 

http://www.devdepot.coni 



NS BASIC 3.e 
for the Newton with 
Visual Designer 

by NS BASIC Corporation 

• A fully interactive implementation 
of BASIC programming language 

• Runs entirely on the Newton - no 
host is required 

■ Create files, access the built in soups, and the serial port for 
input and output 

• Work directly on the Newton, or through a connected 
Mac^C and keyboard 

• Get the BASIC Internet Tool, available at no charge to NS BASIC 
users from www.nsbastc.com 

• Release Notes with sample code are available from the same location 

• Runs on any Newton MessagePad 130 with NS BASIC and the 
Newton Internet Enabler. Also runs on MP 1201s with NOS 2.0 
that have full memory available 

• Write short programs to access News, mail and the web 
tSNSBASIC) Our Price $99 
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There* 1 Here’s a list of all available products. For full product descriptions 
/ please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

LPA MacProlog Developers Edition 

SLPAD 

$995.00 

LPA MacProlog Programmers Edition 

SLPAP 

$495.00 

LS Fortran Pro 

SLSFORT 

$595.00 

US Fortran Plug-In 

SLSFPI 

$199.00 

Mac FORTRAN 11 

SF0RT2 

$595.00 

Power MachTen-UNIX 

SM10PPC 

$695.00 

Presenting Magic Cap 

BPRESMAGIC 

$15.25 

SmalltalkAgents for Macintosh 

SSTA 

$395.00 

Think Pascal 4.0 

SPASCAL 

$165.00 


Web site: http://www.devdepot.conn • E-mail: orders@devdepot.com 
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NetMeter*" 

by AG Group, Inc. 

NetMeter traffic monitoring moduies provide an instantaneous 
view of how a iocai or wide-area network is presentiy 
behaving. By using the industry standard Simpie Network 
Management Protocol (SNMP), NetMeter offers network 
managers a convenient way to monitor ilve traffic statistics 
from any ioca! or remote SNMP-capable device such as Internet routers, servers and 
hubs. Using a wide variety of realtime meter modules, select any interface of a local or 
remote SNMP capable device and continuously monitor utilization, errors and broadcasts 
either transmitted or received by the device. 

(SNETSM) NetMeter Our Price $295 

(SNET) NetMeter with Satellite Our Pirce $395 


Skyiine^/Satellite 

by AG Group, Inc. 

Skyline/Sateliite is a multi-segment Ethernet traffic archiving, 
alert and analysis system designed to monitor, tune and 
optimize heterogenous networks. With a broad, rich set of 
display, reporting and alert options, Skyline (with one or more 
Satellites} identities precursors to network problems, pinpoints 
configuration bottlenecks, tracks peak traffic times and loads, 
quantifies bandwidth usage, as well as measures server and router perfonnance, Find 
under-utilized network segments, overloaded servers, bandwidth abusers and more. 

• Monitor the “pulse" of local or remote Ethernet segments 

• “Baseline" network activity 

• Provide usage reports on parameters you specify 

• dentify configuration issues and possible solutions 
(SSKY) Our Price $795 







EtherPeek^"* for Macintosh: 

by The AG Group, Inc. 

EtherPeek is an award-winning Ethernet 
network traffic and protocol analyzer 
designed to make the complex tasks of 
troubleshooting and debugging mixed- 
platform, multi-protocol networks easy. 
EtherPeek sets the industry standard for 
ease-of-use while offering all the superior 
diagnostic and analysis capabilihes expected 
of a full-featured analyzer. 

• Automatic IP and AppleTalk name-to- 
address mapping 

• Powerful decoding with support for all major 
protocol suites (including IP, AppleTalk, 
Netware IPX/SPX, NetBEUI, NetBIOS, 

DECnet, SMB, OSITAFP and more) 

• Real-time and post-capture packet filtering 

• ProtoSpecs™ technology for fine 
delineation of packet type 

• Plug-In modules for expert packet analysis 
(SEPEEK) Our Price $995 
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Joy Explorer 

by AAA-i- Software 

Joy Explorer gets you started with 

Rhapsody programming quickly: 

• Step by step tutorial for implementing 
simple appiications 

• Graphical application inspector for 
inspecting classes, instances, methods, 
and data structures inside any 
Rhapsody application. 

• interactive sending ot messages to objects 

• Extension to Rhapsody’s Interface 
Builder which permits 
implementation of prototypes right 
within Interface Builder - no need to use 
any tools except Interface Builder; no 
need to compile and link, 

• Example programs with full source code, 
including source code for application 
inspector, 

(SJOYEX) Our Price $69 


Joy Developer 

by AAA-r Software 

Joy Developer is an essential tool for anyone serious about developing for Rhapsody: 

• Rapid application development right within Rhapsody's Interface Builder 

• Incremental extension of existing applications ftest-fix-go) without any need to recompile, relink 
or restart the application 

• Turn interface files into standalone applications that run on any Yellow Box platform simply by 
using the new “Save NibAs App" command in Interface Builder 

• Mix-and-match interpreted scripts and compiled code freely; anything you can do in compiled 
Objective-C and Java can be done in Joy - and more. 

• Full support for alt Objective-C classes, typedefs, macros, data structures, exceptions, Tcl 
8,0 commands and extensions, including byte-code compiler to boost performance 
(SJOYDEV) Our Price $399 

Web Ware 

by BeacfiWare, Inc. 

The ultimate collection of clip media and templates for building your 
own Web Page, An incredible selection of Shockwave movies, 
animated GIFs, buttons, bullets, dividers, and sample l-tTML pages. 
There are literally thousands of graphical elements on this disc, all 
there to spice up your web page. In all, it’s ^out 300 megabytes Cff weatMty only a mouse- 
click away! System Requirements: PC - 486 or better with 8 MB RAM, Sound card, 
SuperVGA, CD-ROM drive, Macintosh - Color Mac with 8 MB RAM, CO-ROM drive. 

(SWEBW) Our Price $24 
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Visual MacStandardBasic 3.0 

by ZCurve Software 

Visual MacStandardBasic is tbe new standard for creating both 

68K and Power Macintosh applications. 

• Applications can be visually created In minutes 

• Visual controls such as command buttons, text boxes, list 
boxes, radio buttons, check boxes, scrollbars, Icons, pictures 
and timers can be created and modified instantly 

• Use color graphics, animations, mowes, sounds and speech 
in your programs 

• Console text window option helps converting older BASIC 
source code from other platforms 

• Online tutorial, manuals, sample projects get you programming quickly 

(SVMACSB) Our Price $29.95 


QC 

by Onyx Technology, Inc. 

High performance runtime stress testing for applications. 

• Tests include heap checks, purges, scranbles, 
handle/pointer validation, dispose/reiease checks, write 
to zero, de-reference zero as well as other tests like free 
memory invalidation and block bounds checking 

• Extremely user friendly - ideal for non-programmer testers 

• Also available in Japanese 
(SOQ Our Price $99 



PowerKey Pro Model 200 

by Sophisticated Circuits 

PowerKey Pro Model 200 lets you start 
up and shut down your Mac and up to 
five peripherals with a 
single keystroke. Two 
groups of switched 
outlets let you control 
some peripherals 
separately. PowerKey 
also features phone 
ring startup which lets 
you access your Mac 
while on the road. 

Powerful scheduling 
features let you 
control your outlets 
with “hot keys” or perform tasks 
unattended. Start up your computer at 
any time of the day or night, open 
applications and run AppleScripts or 
QuicKeys. Add the optional Server Restart 
Option and you can even restart crashed 
servers automatically! 

System Requirements: Mac with ADB 
port. System 7 or later. Telephone 
features require analog phone line. 
(HPKEY2) Our Price $99 


; PowerKey Pro Model 600 

I by Sophisticated Circuits 

PowerKey Pro Model 600 is “the world's 
smartest power strip!” Start up and shut down 
your Mac and 
peripherals with a single 
keystroke. Includes six 
individually-switched 
outlets, with manual 
switches and indicator 
lights. Powerful 
scheduling features let 
you control outlets with 
“hot keys" or perform 
ta^ unattended. Start 
up your computer at any 
time of the day or night, 

■ open applications and run AppleScripts or 
OuicK^s. Complete telephone controllability 
lets you start up the computer, switch outlets 
or mn complex events using custom touch- 
" tone commands. For a limited time. Model 600 
: includes the Server Restart Option. Restart 
j crashed servers automatically! 

System Requirements: Mac with ADB port. 
System 7 or later. Telephone features require 
analog phone line. 

(HPKEY6) Our Price $199 




PrimeBase RDBMS 

by Snap Innovation 

Industrial Strength, Multipiatform 

Client/server RDBMS (relational database 

management system) 

• Easy to install, and easy to maintain 

• Server and client available on; MacOS, 
Rhapsody/OpenStep, Windows95/NT, 
Linux, Solaris. AtX 

• Interfaces: ODBC, DAL, Metrowerks 
PowerPlant, 4D. EOF 

• Single User Runtime available 

• CGI / Application Server available, using 
embedded DAL 

Developer License 
(SPBASDEV) Our Price $50 

Production License 
(SPBASVR) Our Price $820 

(The Production License includes 10 
connections MacOS. Rhapsody or 
VI/indows95/NT) 



SpotCheck 

by GenieWorks, LLC 

SpotCheck is a language-based editor that 
“knows" the Java language. It is designed to 
help a Java programmer produce correct code 
without relying on confusing and untimely 
feedback from a compiler. Specifically, 
SpotCheck identifies syntax errors and 
semantic errors (undefined names, type 
mismatches, etc.) those errors normally 
returned by a compiler. This analysis is 
performed after each edit, giving the 
programmer immediate feedback on errors. 
SpotChedf provides a host of additional 
features, including: 

• smart links to name declarations 

• cross-referenced Java APIs 

• editing with popup menus 

• interfaces to helper apps to compile & run 

• hierarchical project browsing 

• color-coded syntax 
(SCHK) Our Price $59 
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STEP"” 

SOFTWARE 

QuickAgenf'^ is an AppieScript Scripting Addition supporting 
CE Software's QuickMaii LAN products, QuickAgent provides 
QuickMail LAN send and receive capabiiities to any ^pteScript- 
sawy appiication, With fuliy-documented and easy-to-use 
commands, users can send and retrieve QuickMaii messages 
with products like FaceSpan, FileMaker Pro, FoxPro for 
Macintosh, Frontier, HyperCard and SuperCard. Muitipie 
recipients and file enclosures are supported. QuickAgent 
includes example FileMaker Pro templates. 

(SQUICK) QuickAgent (single user) Our Price $99 
(SQUICKL) QuickAgent (site license) Our Price $500 

doScript Plugin for 
FileMaker Pro (Mac only) 

The doScript Plugin is a FileMaker Pro extension for Macintosh 
which activates a script when a user tabs out of a field. This has 
been a requested feature of FileMaker for many years. With the 
new plugin architecture of version 4, this is now possible, 

(SDO) doScript Plugin Our Price $30 

(SDOL) doScript (site license) Our Price $200 
(SDOWW) doScript (worldwide license) Our Price $500 
(SDODL) doScript (distribution license) Our Price $150 

Guide Composer'" 1.2 

by StepUp Software 

• Create powerful Apple Guide help systems for any new or 
existing Macintosh application 

• Provides a WYSIWYG development environment: Guide 
content is developed in Guide windows 

• Design topics, phrases, and panels in the same format as the 
user will use them 

• Features are WYSIWYG interface, Topics, phrases, and 
hierarchical phrases. Coach marks, Fuliy-Integrated with Apple's 
Guide Maker (disfributed vwth Guide Composer), compiles 
scripts automatically, PiCTs in Panels, Generated Guide scripts 
are modifiable 

• FREE Update to all registered Guide Composer users. Demo is 
available at http;//www.guideworks.com/ 

(SGCOMP) Our Price $99 

SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman's 
AppleGuide Starter Kit, Real World AppleGuide 

ScriptGen Pro 

by StepUp Software 

• Installer script generator which requires no programming or 
knowledge of Rez 

• Supports StepUp's InstallerPack, Stuffit decompression, 
Compact Pro decompression, custom packages, splash 
screens, network installs, and resource installation 
(SSCRPTGEN) 0urPrice$169 



NAT ^pUCT! 

■ ■■■"IA fs'’" 

--- 

QuickAgent 


ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C-t-i- classes for 
integrating Internet e-mai! in your 
applications 

• Helps you write software that can 
share mail witi other leading 
e-mail products 

• Royalty-free MIME, SMTP, and 
POPS APIs for Macintosh, Windows, and Unix 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 


BBEdit 4.5 

by Bare Bones Software 

BBEdit 4.5 is a powerful, easy-to- 
learn text and HTML editor that 
offers developers and HTML authors 
the ability to build on its core 
functionality to suite their specific 
needs through its plug-in architecture and scripting capabilites. This 
new version includes: a visual table tool that speeds page and site 
development, contextual menu support tor Mac OS 8, improved 
storage for 'grep' patterns, schptable HTML authoring preferences 
and more. It still provides: unparalleled searching muscle with support 
for both 'grep' style and advanced literal searches, the ability to 
quickly compare differences between files or entire folders, integrated 
support for Symantec’s IDE, Metrowerks CodeWarrior, THINK 
Reference 2,x, MPW Tooiserver and most other environments and a 
heck of a lot more. 

(SBBEDITl 0urPrice$119 
Also see Internet Related, page 12 




CodeBuilder 

by Tenon Intersystems 




■'TENON 

INTER 9VS16MS 


CodeBuilder is a powerful and unique Macintosh software 
development tool for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 


• A powerful Macintosh software development tool suite of C, 
C-t-r , Objective-C, Java, Ada, and Fortran development tools, 

• Complete UNIX & X development environment for developing 
UNIX or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, 
and C, C-I-+, Ada 95 and Fortran 77 

• Web & internet scripting tools: Perl, MacPerl, tol/tk, bash, sh, 
and csh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) 0urPrice$149 
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Check out our Web sitel 



• Full product descriptions • Hundreds of more products 


fi 

http://www.devdepot.com 




AppMaker 


AppMaker 

by Bowers Development 

• Develop ttie user interface for a Macintosh application 
using the original interface builder 

• Just point and click to design your application 

• Creates resources and generates excellent source code 

• Supports most development environments including 
Metrowerks. Symantec, or MPW; C, C++, or Pascal; 
procedural or object-oriented, using PowerPlant, TCL, 
or MacApp 


• The generated code uses the Universal Headers to provide PowerMac compatibility 

• Great tool for beginners to learn object-oriented and Macintosh Toolbox programming 
techniques 

• Includes one-year subscription on CD and hardcopy documentation 
(SAPPMAKE) 0urPrice$199 


Waters Edge Software 



Tools Plus libraries + 
framework 

by Water's Edge Software 

Easily aeate compact, fast running, 
professional looking applications and plug-ins*. 
Tools Plus lets you create virtually any user 
interface element with a single routine, and it 
transparently provides a robust infrastructure to 
make all your pieces work together as an 
application. 

• Simplifies programming and thins source 
code 

■ Automates all standard GUI elements 

• Thousands of extras, from floating palettes 
and tool bars to powerful picture buttons 


• Includes numerous 3D grayscale options 

• Over 1/2 MB of custom fonts, icons, 
cursors, and other resources 

• Includes SuperCDEFs world-class controls 
(an $89 value) free 

CodeWarrior Pro and Gold 
(C/C++& Pascal. 68K&PPQ 
(STOOLCW) Our Price $249 
CodeWanior Bronze (C/C++ & Pascal, 68K) 
(STOOLCWB) Our Price $199 
Tools Plus for Symantec Compilers 
(C/C++ 68K and PowerPC. THINK Pascal 
68K) Requires THINK C 5.0.4 or later, 
Symantec C/C++ 8.0.6 or later {68K) or 
Symantec C/C++ 8.6 (68K and PowerPC) 
(STOOLSYMT) Our Price $249 



Testlfack-Bug Ihicking 
the Macintosh Way 

by Seapine Software, Inc. 

• Tracks bugs, feature requests, test 
configurations, users, and more 

• Includes notifications, security, a 
powerful filter mechanism, and 
multiple reports 

• Links your testers, engineers, 
documentations staff, and project 
managers together to ensure all bugs 
are identified, fixed, and documented 

• Biminates the need to build custom 
bug tracking solutions using general 
purpose database tools 

• Supports single- and multi-user bug 
databases (additional licenses 
required to use multi-user features) 
(STETR) 0urPrice$169 




Feel 
about 
purcb 


V 


OpenGL for 
the Macintosh 

by Conix Graphics 

OpenGL is the premier 3D graphics library that allows software 
developers the ability to develop high-quality, interactive 2D and 3D 
graphics applications. OpenGL can pertorm the following wide range of 
functions which will enhance the development of all graphics software; 

• Geometric primitives ftxyints, lines, and polygons) 

• RGBA or color index mode 

• Viewing and modeling transformations 


Texture Mapping. Lighting, Shading and Z Buffering 
Atmospheric Effects (fog, smoke, and haze) 

Alpha Blending (transparency) 

Antialiasing, Accumulation Buffer, Stencil Planes 
Display list or immediate mode 

Polynomial Evaluators (to support Non-uniform rational B-splines) 
Feedback, Selection, and Picking Raster primitives (bitmaps and 
pixel rectangles) 

Pixel Operations (storing, transfonning, mapping, zooming) 
(SOPENGL) Our Price $389 
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Check out our Web site! 

• Full product descriptions • Hundreds of more products 

littp://www.devdepot.com 



SoftPolish CD-ROM 

by Bare Bones Software 

• The essential tool for software 
quality assurance on the Macintosh 

• Helps you identify inconsistencies 
with Apple's user interface guidelines, 
misspelled words, missing resources, 
and other mistakes 

• Provides tools to put the finishing touches on software distribution 
packages prior to release 

• Works independently of any programming language or environment 

• Ideal for sanity checking software throughout the development 
process 


(SSOFTPOL) Our price $99 


StoneTable 68K/PPC 

by StoneTablet Publishing 

StoneTable is a powerful and professional replacement for the List 
Manager used by developers worldwide. Version 3.0 is a new 
release with many improvements including better clipboard and 
drag/drop integration with other applications. 

• Available for use with CodeWarrior C & Pascal 

• Includes libraries for 68K (A4 & A5) and PowerPC 

• An LTable-ltke class is provided to incorporate StoneTable into the 
PowerPlant environment 

(SSTONEFAT) Our Price $199 


Future BASIC II 

by Sta2 Software 

FutureBASIC II is the award winning 
leader in Macintosh BASIC 
programming. 

• Source level debugger and Interactive compiler/editor 

• Multi-fife Project manager and Multi-file find and replace 

• Super fast compilation, 32 bit clean, and System 7.x savvy 

• QuickBASIC converter 

• Getting Started manual with over 500 example files 

• Full support of standard BASIC 
(SFBASIC2) Our Price $229 



Memory Mine 

by Adianta, Inc. 

• Monitor heaps, identify 
problems such as memory 
leaks, and stress test 
applications 

• Active status of memory in a 
heap is sampled on the tly: 
allocation in non-relocatable 
(Ptr), relocatable (Handle) and 

free space is shown, as are heap corruption, fragmentation, and more 
• Allocate, Purge, Compact, and Zap memory lets users stress test 
all or part of a program 
(SMEMMINE) Our Price $99 



SPOTLIQttT 

m 


SpoUigbt 

by Onyx Technology, Inc. 

Spotlight is a stand alone debugging aid 
that performs memoiy protection (arrays, 
heap accesses, outside your heap, low 
mem, etc), discipline checking t»i toolbox 
calls, and leaks detection. 

• Spotlight is sold on an annual 
subscnption basis 

• The subscription service provides all 
updates 

• Includes maintenance releases tor one 
year after the initial purchase or renewal 
date. 

(SSPTLT) Our Price $199 



by UNI SOFTWARE PLUS 

• Stand-alone version control tool lor ail 
sorts of projects (software 
development, documentation, design. 
CAD, publishing, etc.) 

• Smooth integration with Metrowerks 
CodeWarrior and BBEdit. 

• Simple and dear management of variants 
and revisions of entire projects (not only 
of single files) 

• Easy-to-use graphical project browser gives 
access to all versions that were ever stored. 


• Recording of the complete history (who 
made which changes when and why) 

• View differences between versions (not 
only for text files!) 

• Efficient delta storage of arbitrary files 
(text as well as non-text 

files) gains savings of 95 % and more 

• Administration of users with hierarchical 
access rights 

• Configurable local file locking (Finder flag 
or 'ckid' resource) 

• Scriptabie, essential parts PowerPC nafive 

Single license (SV00D001) $229 

2 pack (SV000002) $359 

5 pack (SV0OD005) $799 

10 pack (SV0OD0010) $1369 

20 pack (SVOODOO20) $2399 

Additional pricing available on request. 

SEE RELATED CATEGORY: Dev. Environments 
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Apprentice 7 

by Celestin Company 



Apprentice 7 is a tiigh'Quality CD-ROM collection of over 600 
megabytes of up-to-date source code, utilities, and info for Mac 
programmers. All of fhe source code and utilities are completely 
new or updated for this release. 


• Frontier 4.1, the highly-acclaimed scripting environment 

• More PowerPlant AND many more PowerPC samples 

• Cool new languages and environments added (Clean, Eiffel, F, 
Tcl-Tk) 

• Hot new demos from leading Mac development companies 
(SAPPRENT) 0urPrice$35 


( The'*'* 


Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

AG Author 
Be Basics 
Bee-one 
BeSpecifjc 3 

C-tree Plus^ Database Handler 
CompiJelt! 


CPU Doubler 
DesignWwks 4.0 
dtp 

EtherPeek 
Fortran 77 SDK 
ICONIX PowerToots-6 Pack 
ICONIX PowerTools-8 Pack 
ICONIX PowerTools-10 Pack 
ICONIX PowerTools-AdaFlow 
ICONIX PowerTools-ASCII Bridge 
ICONIX PowerTools-CoCoPro 
ICONIX PowerTools-DataModeler 
ICONIX PowerTods-FastTask 
ICONIX PowerToois-FreeFlow 
ICONIX PowerTools-Object Modeler 
ICONIX PowerTools-PowerPDL 
ICONIX PowerTools-QuickChart 
ICONIX PowerTools-SmartChart 
ICONIX Training & Consulting 
IMSL Math and Slat Library 
Info-Mac X 

fonizer Real Time Spectral Reshaping Tool 
UveAccess^'^ 1 User Edition 
UveAccess^'^ 1 Developer Edition 
UveCard 
LJ Profiler 
MacA&D 6,0 

MacRow'“: Flowchart Design and Development 
Mac Source II 
NetMinder Ethernet 
Nisus Writer 5,0 

Phyia^*^: Object-Oriented Database 
Pilot Attach^ Diski 

Plan & Track*Project Planning and Management 

QUED/M 3,0 

r-tree Report Generator 

Spellswell Plus 2.1 

Step-Up Inslaller Pack 

SuperAnalyst 

SuperPlot 

SuperPlotPRO 

THINK Pascal (68K) 

Visual Caf^ 

VTeKt 


CODE 

OUR PRICE 

SAGA 

$ 99.00 

SBEBASfC 

$ 69.00 

SBEEONE 

$ 139.00 

SBESPEC 

$ 39.00 

SCTPDH 

$ 895.00 

SCOMPIT 

$ 149.00 

SCPU2X 

$ 79.00 

SOWORKS 

$ 995.00 

SDTF 

$ 695.00 

SEPEEK 

$ 745.00 

SF77 

$ 699.00 

SICPP6 

$ 5 , 945.00 

SICPP8 

$ 6 , 945.00 

SICPP10 

$ 7 , 845.00 

SICADA 

$ 1 , 395.00 

SICASCll 

$ 1 , 395.00 

SICCOCO 

$ 1 , 395.00 

SICDATAMOD 

$ 1 , 395.00 

SICFASTIASK 

$ 1 , 395.00 

SICFREEFL 

$ 1 , 395.00 

SIC08JM0D 

$ 1 , 395.00 

SICPOWER 

$ 1 , 395.00 

SICQUICKCH 

$ 1 , 395.00 

SICSMART 

$ 1 , 395.00 

TfCONlX 

$ 2 , 945.00 

SIMSLSTAT 

$ 495.00 

SfNFOMACIO 

$ 39.00 

SJONIZER 

$ 800.00 

SLAUE 

$ 69.00 

SIADE 

$ 99.00 

SLCARD 

$ 149.00 

SUPHOF 

$ 295.00 

SMACA3P 

$ 1 , 995.00 

SMACFLO 

$ 179.00 

SMACSOURCE 

$ 29.95 

SNETMD 

$ 715.00 

SNI^SW 

$ 220.00 

SPHYLA 

$ 179.00 

APATCHE 

$ 29.00 

SPLNTRK 

$ 179.00 

SQUEDM 

$ 89.00 

SRTRG 

$ 445.00 

SSPELL 

$ 49.00 

SINSTALL 

$ 219.00 

SSANAL 

$ 99.00 

SSPLOT 

$ 195.00 

SSPLOTPRO 

$ 295.00 

STOOLPAS 

$ 149.00 

SVCAFEMAC 

$ 199.00 

SVTOCT 

$ 349.00 
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Lasso 2.5 is ttie ultimate 
FileMaker Pro Web development 
tool for creating online stores, 
discussion groups and other 
robust web applications that can 
handle hundreds of thousands of 
hits per day. Over 50 new tags 
including math, string and variable allow unparraileled data 
handling capability. Create embedded operations with the inline 
command. Lasso Server edition supports multihoming and offers 
superior performance. 

Order Lasso today the award-winning tool that which sets the 
standard for Mac OS dynamic Web database publishing. 
•Multi-threaded performance 

• Supports CDML and LDML 

• Enhanced security for electronic commerce 

(SLASPG) Lasso 2.5 CGI/Plug-ln Our Price $499 

(SLASSVR) Lasso 2.5 Server Our Price $649 


2.5 

By Blueworld 
Communications 


**** M 



BBEdit 4.5 

by Bare Bones Software 

(SBBEDIT) Our Price $119 

Also see Tools. Libraries and 
Utilities, page 8 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http;//www.devdepot.coiii 


Newstand 

by Imagina 

Newstand is the fast and easy 
workgroup collaboration 
software for schools, 
corporate Internet / intranet, and ISPs. As a Usenet server with 
drag-and-drop configuration, Newstand can easily limit access to 
only the most relevant newsgroups if desired, and create internal 
discussion groups as well. Because Newstand is "Internet 
standard." employees and students around the globe are able to tog 
into the secure intranet with an Internet news reader. 

• Provides intuitive drag-and-drop administration interface 

• Eliminates reliance on UNIX, or any other non-Mac platform 

• Achieves high performance using Open Transport and 
multithreading 

• High speed custom database 

• Holds over 2,000,000,000 articles total 

• Send and receive multiple simultaneous newsfeeds 

Newstand Lite 

• Supports up to 16 simultaneous connections 

• One outgoing feed 
(SNEWLITq Our Price $498 

Newstand Pro 

• Supports approximately 100 simultaneous connections 

• Unlimted usem 

• Up to 20 incoming / outgoing feeds 
(SNEWPRO) Our Price $988 



WebTen 

by Tenon Intersystems 
WelrTen is an industrial- 
strength, high- 
performance Apache Web 
server for Power Macs. 

WebTen's Web-based 
browser interface enables 
local or remote 

administration via your favorite brow^. Since Apple's NeXT 
acquistion, Tenon has extended their unique “UNIX virtual machine’ 
technology to produce a set of “Rhapsody-Ready" internet 
applications. WebTen is the first offering in this series. 

• WebTen is the fastest Web server on Power Macintosh 

• Sustains up to 10,000 connections a minute, or over 10 million 
connections a day 

• Apache runs in Tenon's multi-threaded, pre-emptive 
multitasking environment 

• Tenon's unique technology support the widely acclaimed 
Apache Web server as a double-clickable Macintosh application 
(SWEBTEN) Our Price $495 


CyberStudio 

by GoLive Systems 
GoLive CyberStudio is the 
complete solution for HTML 
layout, design and Web site 
management. It gives Macintosh 
users unprecedented creative 
control and flexibility when 
designing a Web site. GoLive CyberStudio lets graphic 
designers and publishers visually design and manage a 
professional-quality Web site—including the latest multimedia 
features—without performing any HTML programming. Yet. 
GoLive CyberStudio also includes HTML source-code and 
JavaScript tools, which help Web designers and programmers 
integrate interactivity into a site. Because GoLive CyberStudio 
is the first Web site design software to always work in a native 
HTML file format, it allows graphic designers and Web 
programmers to work well together. 

(SCYBERS) Our Price $349 
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PageCharmer: Sizzling Effects... 



PageCharmer 1.0 

by Mainstay 

PageCharmer is a set of customizable interactive applets that 
enhance web pages without writing a single line of HTML code. 
Whether the web site is already up and running or designing one 
from scratch, PageCharmer gives you the power to make it stand 
out from the crowd with sophisticated applets that can be 
personalized to fit most any need. 

FEATURES: 

LiveG-Map, LiveT-Map, LiveG-Button, UveT-Button, LiveGT-Button, 
LiveG'Ticker, LiveT-Tlcker, LiveG-Marquee, and LiveT-Marquee. 
(SPGCHRM) Our Price $99 


Power MachTen 4.0.3 

by Tenon Intersystems 

MachTen is the only Macintosh product that can turn your 
Macintosh into a complete Unix workstation. Based on BSD4.4 
and the Mach kernel, MachTen brings the power of Unix to 
your desktop at an extremely attractive price point. MachTen 
enables you to: 

• Run a high speed internet server, complete with WWW, FTP, 
NFS, DNS and print service 

• Build a Mutihomed Web Server 

• Develop applications in a Unix development environment, 
replete with the acclaimed GNU development toolset 

• Program in Ada, C, C++, Pascal, Fortran, and more 

• Run Xwindows applications, from remote workstations or on 
your Macintosh 

• Run hundreds of Unix applications, already ported for 
MachTen and available on our Ported /^plications CD-ROM 

• Run Software.com Inc's acclaimed Post.Office mail transport 
service 

(SM10PPC) Our Price $895 


Rumpus 

by Maxum Development 

Maxum’s new, high- 
perfonnance FP server for 
the MacOS. Based on 
Maxum’s RushHourTCP/IP implementation. Rumpus 1.0.1 offers 
the performance and reliability of high-end workstations with the 
ease of use, security, and flexibility of the Macintosh. 

• Simplified setup, with no need to configure AppleShare, File 
Sharing, or Users & Groups for simple anonymous FP 

• Anonymous and/or secure server access, with separate security 
settings for anonymous \is. secure users 

• Automatic MacBinary and Binhex encoding 

• Complete logging, with separate anonymous and secure access 
logs, including anonymous user passwords 

• Up to 32 simultaneous connections 
(SRUMP) Our Price $195 




CGi Toolkit 

j ^ ^ by Pictorius, fnc. 

i ! afafRw The Pictorius CGi Toolkit is the fast and 
easy route to high performance CGIs and 
ACGIs for your Mac Web site. 

• Interactively develop CGis while the 
web server, the CGi Toolkit and the browser are running on the 
same machine 

' Interactively develop, test and debug CGIs before compiling 
' Powerful debugger allows you to edit code, roll back, code and 
change input values while your application is running 
' Fuliy object oriented so you can re-use your code 
' Automatic handling of Apple Events so you can concentrate on 
building functionality 

' Easy creation of multi-function CGfs whlcti reduces application 
footprint and RAM usage 



(SCGtTLKT) Our Price $149 
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Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

HyperGuide 1.0 

SHYPGUD 

$149.00 

ObjectSet 

SOSMSDK 

$495.00 

OOFILE Reporter Writer 

SOORW 

$499.00 

ScriptDemon 

SSDEMON 

$949.00 

WedAllas 1.0 

SWEBALS 

$129.00 
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TCP/IP 

Script! 140 Additton'' 

lAr bdirTfirt 


TCP/IP Scripting Addition 

by Mango Tree Software 

• Award-winning AppleScript scripting 
addition 

• Allows you to write scripts using 
MacTCP™ commands in AppleScript™ 

• Send e-mail or files through a script, 
check if users are logged on (via Rnger), automate FTP, Gopher, 
NelNews, Telnet, and LPR, verify links in HTML documents, and 
quickly write many other TCPAP client-server programs 

• Works with AppleScript, MacTCP 2.0.4 and Open Transport 
(STOP) Our Price ^9 


Scripter 2.0 

by Main Event Software 

For professionals, for novices, for 
webmasters, for solutions providers, 
there's only one serious choice. Scripter! 

• Scripter and FaceSpan work together: 
one click opens your FaceSpan script in 
Scripter, another sends it back 

• Debug handlers without modifying your scripts using the Call 
Box 

• Applet simulation, live editing. Object map, associated 
terminology 

• Search backwards, block generators, more navigation 
shortcuts, more drad-and-drop, and an even more enhanced 
trace log 

• Now Includes ScriptBase; stores your data and media elements 
and share them between scripts all with a special new browser 

• Easily write and compile scripts hiat have handler declarations 
and other vocabulary specific to a particular scriptable 
application 

• Scripter Is the natural companion to AppleScript for users at all 
levels of proficiency. Don’t write scripts without It! 

(SSCRIPTER) Our Price $199 



pynaMorph1.5 BtemalWlEliMft. 

by Morph 

DynaMorph is a powerful cross-platform, server-side scripting 
language that allows you to access databases, dynamically create 
web graphics, process forms, validate credit cards, etc. Available for 
Mac, Windows NT/95, and UNIX, DynaMorph makes interactive sites 
and applications porU^le between platforms. 

(a)YNA) Our Price $499 




FaceSpan v3.0 

by Digital Technology 
International 

FaceSpan is a cutting edge interface 
design and rapid application 
sfeveiopment (RWD) tool which gives 
you the power to build and customize Macintosh applications quiddy 
and easily. 

• Acts as your front end for AppleScript or any other OSA (Open 
Scripting Architecture) language 

• Allows you to automate often-repeated tasks, customize and 
integrate existing applications, build new applications and 
personalize your computing environment 

• NEW! Allows you to create interfaces and applications that 
conform to the Mac OS 8 look and feel 

• NEW! Supported display objects now include tab panels, 
disclosure triangles, bevel buttons and more 

• NEW! FaceSpan run-time now launches up to 5X faster 

• Includes an unlimited, royalty-free distribuhon license tor the 
interfaces and applications you create 

(SFACESPAN) Our Price $149 


Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get the most from 
AppleScript! 

• Advanced debugging environment offers 
single-step script execution with 
breakpoints 

• Script Debugger dictionary browser 
features a graphical view of objects 
provided by scriptable applications 

• Includes Late Night Software Scripting Additions - a collection of 
more than 70 new AspleScript commands, and Scheduler, a utility 
that allows you to launch scripts at pre-determined times 
(SDEBUG) Our Price $129 

WindowScript 

by Royal Software, Inc. 

WindowScript is the ultimate tool tor designing Macintosh user 
interfaces using HyperCard. Design Real "Macintosh" user- 
interfaces right inside HyperCard. Until now you either created 
HyperCard stacks or Macintosh applications. With WindowScript you 
can literally bring the look and feel of a real Macintosh user- 
interface to I lyperCard. If you're a HyperCard developer, interface 
designer, application developer, program manager or tester 
searching for a prototyping tool, WindowScript is perfect for the job. 
(SWSCRIPT) Our Price $149 



t there'*; 


Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT CODE OUR PRICE 

PrePab Player SPLAYER $95.00 
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CyberStudio 

by GoUve Systems 

GoLive CyberStudio is the 
complete solution for HTML 
layout, design and Web site 
management, it gives 
Macintosh users 
unprecedented creative control 
and flexibility when designing a 
Web site. GoLive CyberStudio 
lets graphic designers and publishers visually design and 
manage a professional-quality Web site—including the latest 
multimedia features^—without performing any HTML 
programming. Yet. GoLive CyberStudio also includes HTML 
source-code and JavaScript tools, which help Web designers 
and programmers integrate interactivity into a site. Because 
GoLive CyberStudio is the first Web site design software to 
always wor1< in a native HTML file format, it allows graphic 
designers and Web programmers to work well together. 
(SCYBERS) Our Price $349 


NewtCard 

by KS BASIC Corporation 

NewtCard lets you put text, 
drawings, pictures and sound 
into a stack of smart cards on 
your Newton. Add buttons to 
navigate, fields to collect data, 
and scripts to bring your project 
alive with the tap of a pen! 

• Create business solutions, 
education courseware, inter¬ 
active presentations and more in 

• Enter text, numbers dates and times easily. 

• Create your own drawings or copy drawings and text from 
NewtWorks 

• Navigate to other cards, stacks or applications by clicking 
buttons you create. 

• Add scripts to your stacks in easy to use BASIC! 

(SNEWT) Our Price $99 


ExposurePro 

by The Beale Street Group, Inc. 
ExposurePro allows you to, at the touch 
of a key (user-detined, of course], 
freeze the screen, select a portion with 
the powerful selection tools, and save 
the image to a TIFF, GIF, PNG, JPEG, 
PICT, or PICT clipping file. You can also 
save to the Clipboard, Scrapbook, or 
even send it directly to your printer. 

The power of ExposurePro lies not only in 
its screen capture capablihes, but also in the vast array of editing tools: 
painting tools, drawing tools, all with customizable features rivaling a 
full-blown image editing program. Convert to a different bit depth. 
Dither. The text tool might make you trash Illustrator! 

(SEPRO) Our Price $119 


Widgetizer 

WICIyd/ ^xi/v Widgetizer is Roundabout’s 

peedess rapid object editor for 
QuickTime VR. Widgetizer generates interactive QTVR object 
movies which look in at a center point or plane, simulating the 
effect of holding an object in the hand and turning it around to see 
all sides, top and bottom. 

• Definable hot spots 

• Custom backgrounds 

• Frame-based animation 

• Sound integration 

• Small memory footprint 

• Clean user-friendly interface 

• Plug-in architecture 

• Exports both QuickTime VR 1.0 and 2.0 

• Photoshop Acquire Module that supports all devices Including 
film cameras, (through scanners or photo CDs), digital cameras, 
video camera and digital video cameras. 

• Supports device (mechanism) software controlled QTVR object rigs 

• Expensive software controlled mechanisms are not required. 
System Requirements: Runs on 68K or Power PC: requires 
allocation of 8 mb real RAM. 

(SWIDG) Our Price $169 






an easy to use enwronment. 



Nodester 

MA Roundabout Logic 

in w U Nodester is Roundabout’s 

renowned rapid panoramic 

editor for QuickTime VR. Nodester generates interactive QTW 
panoramic movies which look out from a center or nodal point, 
allowing the viewer to experience the effect of a full 360 degree 
panorama. 

• Hot spot editor 

• Built- in image editor 


• Photoshop Acquire Module that supports all devices including 
film cameras, (through scanners or photo CDs), digital cameras, 
video cameras and digital video cameras. 

• Small memory footprint 

• Clean user-friendly interface 

• Plug-in architecture 

• Export both QuickTime VR 1.0 and 2.0 

System Requirements: Runs on Power PC only; requires 
allocation of 8 mb real RAM. 

(SNOOE) 0urPrice$169 


Web site: http://www.clevdepot.com • E-mail: orders@devdepot.com 
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Digital Imaging Technology 


QuickTime VR Authoring Studio is Now Available for only $299 
when you purchase selected Kaidan producte. 





Get the QTVRAS for only $299 when you purchase the KiWi+, QuickPan Magnum or Magellan QC. This is a savings of approximately $95 off 
the standard retail price. Sorry, upgrades from the original VR Suite are not available. 

(HQTKB) Our Price $299 

Available only with Kaidan products KiWi+, QuickPan Magnum and Magellan QC. 

QuickPan Magnum 

by Kaidan 

The QuickPan Magnum Series 
consists of two models, the QPX-1 
and QPX-2. Featured on boUn 
models is the new QPU-2 camera 
bracket, Based on the highly successful 
KiV/i, it provides a shjrdy, 
collapsible system for the 
mounting and adjusting of a 
wide variety of cameras and 
camcorders. The new base designs 
used on the Magnums are a refinement 
of our earlier bases, with the QPX-1 having a fixed base and the 
QPX-2 having a new low-profile micro-tilt adjustment stage. The 
easily adjustable click-stops will let you capture a panorama in a 
few seconds. The QPU-2 has two accessories, a Landscape 
Bracket for positioning the camera in the landscape orientation 
(QPLB-1) and a Counterweighting Kit (QPCW-lj used to balance 
large cameras or camcorders, such as the Sony VX-1000, that 
have a center of mass well behind the pivot axis, 

QuickPan Magnum-1 (HQPMAG1) Our Price $499 
QuickPan Magnum-2 (HQPMAG2) Our Price $549 


Magellan Desktop Turntable (MDT-19) 

by Kaidan 

The MDT-19 is a motorized turntable used to index objects, under 
computer control tor immersive imaging object photography (i.e. 
Apple QuickTime VR, Live Picture Reality Studio), it has a diameter of 
19 Inches and supports objects up to 100 lbs, The turntable is 
coated in a durable matte biack finish and also can be topped with 
optional blue, green or red-screen elastic caps. Indexing is 
accomplished with our new eMCee"^^ II controller which connects to 
the serial port of your computer (Mac software available now, 
lAfindows software available Q3-1998). The Mac version also 
supports AppleEvents (direct QuickTime VR Authoring Studio 
connection) and is AppleScriptable, providing comprehensive and 
flexible control. 

Feature...Benefits: 


QuickPan Magnum Accessories 


Counterweighting Kit 

The Counterweighting Kit includes a weight and adjustable arm 
that Is used to offset the weight of large, heavy cameras and 
camcorders. 

(HWHTKT) Our Price $129 


19” Diameter with rounded edge...Large surface with no “hard" 
edge to show in images 

Sturdy design and powerful molor,..Supports heavy objects up 
to 100 tbs 

Optional blue, green and redscreen covers...Save time in post¬ 
production editing 

Optional telescoping pedestal kits...Elevate objects in order to 
capture underside details 

Compact eMCee II controller...Purchase only one and use on 
future motorized products 

Scriptable software...Easily set and program turntable motion 
(HDESK) Our Price $799 


Detent Wheel 

Detent Vl/heel (5-inch) (Color = Purple); 10,14,18,24 and 30 
Position (QPDD-2) 

(HQDVl/HLS) Our Price $49 

QuickTilt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2, that mounts between your panhead or camera 
and your tripod. It makes the leveling process quick and easy, 
Particularly useful when you plan to shoot a number of 
QTVRA/R nodes in a short period of time. 

(HQTLVUt) Our Price $149 
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KiWi 

by Kaidan 

TheKiWi’“ 
is the most 
affordable VR/OTVR 
panhead, bringing digital 
photographic panoramas 
to an even wider audience. 

It's the perfect companion to 
programs such as QuickTime VR Authoring Studio, PhotoVista and 
Nodester, providing a complete solution for anyone interested in 
adding VR panos to their websites and multimedia applications. 

The KiWi™ consists of two intersecting black anodized aluminum 
struts that adjust and lock to accommodate a wide range of 
cameras, such as the Apple OuickTake 100/150/200, Kodak 
DC50/120, APS film c^eras and 35mm SLRs equipped with wide- 
angle lenses. KiWi™ attaches to any standard tripod and camera 
equipped with a standard 1/4-20 mounting thread. 

(HKIWI) Our Price $99 




KiWi+ 

by Kaidan 


The KiWi-r adds a compact, yet 
durable click-stop mechanism and the 
same twin-axis bubble level found on the top-of-the-tine QuickPan 
Magnum Series heads. The twin-axis bubble level (recommended 
by Apple and VR professionals) provides a clear indication of level, 
even when the unit is slightly above eye level. The click-stop 
mechanism uses easily replaceable detent discs, which are 
available in a number of positions (8.12,16,18,20). The KiWi-i- 
ships with one disc of your choice and extra discs are available 
separately or as a set. The click-stops speed the process of 
shooting a panorama by eliminating the need for the photographer 
to look at the unit in order to visually align the index increment. 


Kiwi -I- Ships with detent disc of your choice 


KiWi-r with detent disc size 8 
KiWi-r with detent disc size 12 
KiWi-r with detent disc size 16 
KiWi-r with detent disc size 18 
KiWi-i- with detent disc size 20 


(KIWIP8) Our Price $249 
(KIWIP12) Our Price $249 
(KIWIP16) 0urPrice$249 
(KIWIP18) Our Price $249 
(KIWIP20) Our Price $249 


KiWi and KiWi+ Accessories 


QuickTilt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2, that mounts between your KiWi or KiWi-i- and 
your tripod. It makes the leveling process quick and easy. 
Particularly useful when you plan to shoot a number of QTVR/VR 
nodes in a short period of lime. 

(HQTLVLR) 0urPrice$149 

KiWi-to-KiWi+ Upgrade 

Includes the necessary parts required to turn your KilA/l into a 
KiWi-r — adding click-stops and the twin-axis bubble level. Comes 
with a detent disc of your choice (8,12,16,18 or 20 positions). 
(HKIWIUP) Our Price $199 

KiWi+ Detent Discs 

KiWi-r Detent Discs are available singly or in a set of four. In both 
cases you get to choose whichever discs you need. 

(HDTDISC) Our Price $24.95 each 

(HDTDISC4) Our Price $89 set of four 

Choices include: 8,12.16,18, or 20 position detent disc 


Web site: http://www.devdepot.com • 


Landscape Bracket 

The Landscape Bracket is a right angle bracket that allows you to 
mount the KiWi or KiWi-r upright camera bracket in a horizontal 
orientation. This bracket is primarily used for cameras ttiat have a 
limited field of view and you need to limit the number of shots. 
(HLDBRAC) Our Price $42 

Flash Hotshoe Level 

A dual-axis bubble level that slides into your camera's hotshoe. It's a 
useful tool to help level the camera on the upright camera bracket. 
(HFLASH) Our Price $39 

Offset Spacer 

The Offset S^er is a circular spacer that may be required for 
very narrow cameras Ci.e. certain Ricoh digital cameras) in order 
to position the center of the lens over the pivot aoris. 

(HOFFSPAC) Our Price $24.95 


E-mail: order$@devdepot.com 
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Media Cleaner Pro 

by Terran Interactive 

Use Media Cleaner Pro 2.0 to optimize and compress video for 
CD-ROM. kiosk, or the Internet. Media Cleaner Pro automates 
your work tlow allowing you to get the highest quality video, 
faster and easier than any other program on the market. 

• Includes Adobe Premiere Export module 

• Optimal palette generation, Drag-and-drop batch processing 

• RealMedia, VDOLive and improved QuickTime support 

• Dynamic Preview Window, the Media Wizard, multiprocessor 
support and more! 

System Requirements: 

68040 Mac or better (PowerPC strongly recommended, req'd for 
RealMedia), QuickTime 2.0 or later (2.5 strongly recommended) 

8 Mb application RAM, MacOS 7.0.1 (7.5 or later recommended) 
SoundManager 3.2, CD-ROM Drive 
(SMCP) Our Price $359 




Order Ml-iree 
aOO-MACDEVd 


1800622-33811 


Music Tk^cks 

by BeachWare, Inc. 

A new PC/Mac & Audio multimedia music 
CD-ROM. The clips include musical 
introductions, fanfares, background music, and more. This collection 
offers you 100 music clips stored in .WAV format for Windows, 
SoundEdit & AIFF formats for Macintosh and as Audio tracks for 
audio CS players. All of the music clips are completely license and 
royalty-free!! Mac System requirements: Mac Plus or greater. CD- 
ROM drive. PC system requirements: Windows 3.1 or later, Sound 
Blaster compatible board. CD-ROM drive, 

(SMI) Our Price $24.95 



iwtiaiFi - ■ 


MultiWare 




Multimedia Collection 

by BeachWare, Inc. 

Introducing a new Audio multimedia music 
CD-ROM for the Macintosh. This dix is a collection of clips ideal for 
Desktop Presentations and other Multimedia applications. This incredible 
collection of license-free media clips is bursting with 240 + color pictures 
and backdrops (PICT), 200+ sound & music clips (SoundEdil), 140+ 
QuickTime movies, and a variety of multimedia tools fw use with the 
Macintosh. 

(SMWMC) Our Price $24.95 



Here are more products. For full product descriptions please see our Web 

fhere's 

site, or feel free to call, fax, or E-mail us. 



PRODUCT 

CODE 

OUR PRICE 



AudioTrack 

SAUDIOTRK 

$270.00 



Be Studio 

SBESTUD 

$99.00 



Captivate 4.6: Essential Graphics Utilities 

SCAPT1V 

$79.00 



ClipVR 

SCLIPVR 

$89.00 



Rash Hotshoe Level 

HFLASH 

$39.00 



HyperGuide 1.0 

SHYPGUD 

$149.00 



Landxape Bracket 

HLDBRAC 

$42.00 



Magellan QC 

HMAGQC 

$299.00 



Magellan QC Detent Wheels 

HMDWHLS 

$74.00 



Magellan QC Pedestal Set 

HMAGPED 

$39.00 



Media Cleaner Pro 

SMCPUP 

$359.00 



Offset Spacer 

HOFFSPAC 

$24.95 



Screen Machine 

SSM 

$24.95 



WebAlias 1.0 

SWEBALS 

$129.00 
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Duke Nukeiii™3D 

by MacSoft 

Prepare Yourself for the Ultimate 3D 
Slugfest! Murderous aliens have landed in 
futuristic Los Angeles, and the humans 
suddenly find themselves atop the 
endangered species list. The odds are a 
million-to-one, just the way Duke likes it! 

Features; 

• 39 LEVELS OF MAYHEM 

• FULL MOVEMENT CONTROL lets you run, jump, crawl, 
swim,and jetpack your way through hostile environments. 

• MULTIPLAYER DUKEMATCH feature lets you duke it out one- 
on-one via modem, local area network, serial cable and more. 

System Requirements: Any 68040, Power Macintosh or compatible 
with at least SMB RAM, 256'COlor monitor and CD-ROM drive. 16MB 
RAM recommended for 68040 version, Power Macintosh recom¬ 
mended for network play. 

(SDUKE) Our Price $29.95 

Master of Orion™ II 

by MacSoft 

Forge an empire to span a universe. 
Colonize unknown planets and trade 
with other races for their knowledge. 
Conquer alien star systems to secure 
the resources that will guarantee your 
supremacy. 

• Explore and colonize uncharted planets. Form a colony or 
take over one of your enemies’. 

• Manage resources - run your colonies the way you see fit: assign 
careers, maintain populahon morale and constmct buildings. 

• Research more than 200 technologies, or, trade with other 
races for theirs, 

• Multiplayer options for up to eight players. Play via modem, 
network, hot seat or TCP/IP. 

System Requirements: Any 68040 or higher with at least 
SMB RAM, color monitor and CD-ROM drive. Also accelerated 
for Power Macintosh. 

(SMASTj Our Price $29.95 





Quake® 

by MacSoft 

From the creators of DOOM® and 
DOOM ir“ comes ttie most 
intense,technologically advanced 3D 
experience ever captured on CD-ROM. 

Features: 

• Free and fluid motion 


• Ambient sound 

• Incredible lighting effects 

• Play solo or against others via Internet, modem, LAN or serial 
connection. 

System Requirements: Any Power Macintosh with at least 
16MB RAM, color monitor and CD-ROM drive, 


(SQUAKE) Our Price $29.95 


Civilization® II 

by MacSoft 

Make every critical social, economic and 
political decision as you build an empire 
to span history. Compete against some 
of the greatest leaders of ail time. So 
plan your every move carefully. Because 
in this game, you either stand the test of 
time or you're history. 

• Command powerful armies. 

• Negotiate with rival empires, 

• Devise and control technology. 

• Construct Wonders of the World. 

• Enjoy all-new graphics. A multifunctional Map Editor allows you 
to create unique worlds from a vast array of terrain. 

System Requirements: Any 68040 or higher with at least SMB 
RAM, color monitor and CD-ROM drive. Also accelerated for Power 
Macintosh. 

(SCIVIL) Our Price $46.95 



More games by 


Deadlock 

SLOCK 

$19.95 

Piay to Win Casino 

SWiN 

$19.95 

Real Pool 

SPOOL 

$19.95 

Shadow Warrior 

SSHAD 

$29.95 

Top Gun 

SGUN 

$46.95 



Here are more products. For full product descriptions piease see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

1000 Games for the Macintosh 

STGM 

$24.00 

A Zillion Sounds 

SAZS 

$24.00 

Abuse 

SABUSE 

$51.00 

Casino! 

SCAS 

$24.00 

Classic Arcade 

SCLA 

$24.00 

Maratiion Trilogy Box Set 

SMTBS 

$65.00 

Myth The Fallen Lords 

SMYTH 

$49.00 

Night Sky Interactive 

SNSI 

$24.00 

PowerSD 

spvmsD 

$249.00 

Trivia Warehouse 2000 

STW2K 

$24.00 


Web site: http://www.devdepot.conn • E-mail: orders@devdepot.com 
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Java Distributed 
Computing 

By Jim Farley 

This book offers a general introduction 
to distributed computing, meaning 
programs that run on two or more 
systems. It focuses primarily on how to 
structure and write distributed 
applications and discusses issues like 
designing protocols, security, working 
with databases, and dealing with low bandwidth situations. 

(8DJAVA) Our Price $29 


JAVA 


DistribNle'ti Cumpalut^ 


& Canada: 805-494-9797 • 


New QuickTimeVR for 
Photographers Video! 

by Harry Liles 

Here's the first video devoted entirely to the 
creation and usage of QuickTime VR. The 2 hr 
tape covers QTVR applications, equipment, 
techniques, business practices and much 
more. The tape is available in NTSC, SECAM 
and PAL formats. 

(VQTVR) Our Price $49 


Advanced Filemaker Pro 
4.0 Developer Guide 

By Chris Moyer 

A useful and straightforward manual for 
FileMaker Pro 4.0, this book is loaded 
with valuable tips for high-end 
developers, especially those who are 
developing databases as a back-end to 
applications. 

(BRLEP) OurPrice$39 

Scripting Languages: 
Automating the Web 

By D. Dougherty, P. Lomax, G. van 
Rossum, & N. Meinie 


GoLhre CyberStudio 2 
for Macintosh: Visuai 
QuickStart Guide 

by Shelly Brisbin 

For Web designers who want to get the 
most out of CyberSludio’s WYSIWYG 
interface and professional site 
management tools, there's help. 
Peachpit's Visual QuickStart Guide 
offers an easy, visual approach with 
step-by-step instructions and lots of screen shots. These guides are 
designed to provide the information you need in a concise, 
straightforward commentary, so you won't have to wade through 
long-winded paragraphs and can get up and oinning In no time. 
There's no better quick referent* on the market, 

(BUVE) Our Price $17 


This book guides users and developers 
In choosing and deploying scripting 
solutions. Users can add scriptable and 
extensible behavior to the Web in a 
variety of ways. The book offers an 
array of articles in Web client user 
Interface, Web server programming interface, the World Wide Web 
gateways, and Web database connectivity. 

(BSPWWW) Our Price $26 


The OuickTimeVR Book 

by Susan Kitchens 

The concise informaOon in The 
QuickTime VR Book shows you how to 
add QuickTime VR content to your Web 
site or CD-ROM. It covers the basics of 
virtual-reality technology and such topics 
as planning yrxjr movie, viewing, and 
creating panoramas and object movies, 
understanding and setting up hot spots, 
and linking large projects together. An indispensable resource for Web 
and multimedia producers, photographers, and 3D artists. 

(BQTVR) Our Price $35 


Shockwave Studio 

by Bob Schmitt 


This book shows how to create 
compelling and functional Shockwave 
movies for web sites by examining 
projects of leading multimedia 
developers and teaching — by 
example — many of their tricks for 
using Director. Covers techniques for 
reducing the byte size of movies, 
avoiding problems with color palettes, using Net-specific lingo, and 
using streaming Shockwave audio. Includes CD-ROM with dozens of 
actual movies by leading web develr^rs. 

(BSHOCI^ Our Price $35 






























LINUX: Installatton, 
Configuration, Use 

by Michael Kofler 

If you are looking for one book to teach 
you all the basics of Linux, from 
installation and usage to simple 
programming, then this is the book for 
you. Linux: Installation. Configuration and 
Use will get you up and running with 
Linux quickly and effectively, cutting out 
time-consuming installation problems and searches for on-line 
documentation. Whether you are a Systems Administrator or a Linux 
novice, this book will provide you with a cohesive, authoritative 
introduction to Linux handling. 

(BLAIXCON) Our Price $31 


A Practical Guide 
to Linux 

by Mark Sobell 

This new book by best-selling UNIX 
author Mark Sobell combines the 
strengths of a tutorial and those of a 
reference to give you the knowledge and 
skills to master Linux. Uniquely designed 
for both beginners and experienced 
users, A Practical Guide to Linux requires no prior programming 
experience. It begins with an extensive tutorial to bring those with 
less experience up to speed, and then quickly progresses to detailed 
chapters on GUIs, networking, the vi and emacs editors, three 
popular shells, programming tools, and system administration. 
(BGDLNX) Our Price $35 




Designing with 


by Nick Heinie 

Written by the author of the “JavaScript 
Up of the Week" web site, this Web 
Review Studio book focuses on the most 
useful and applicable scripts for making 
truly interactive, engaging web sites. 

You’ll not only have quick access to the 
scripts you need, you'll finally understand why the scripts work, how 
to alter the scripts to get the effects you want, and, ultimately, how 
to write your own groundbreaking scripts from scratch, 

(BDJAVA) Our Price $26 

Web site: http;//www.clevdepot.com • 
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TCP/IP Addressing 

by Buck Graham 
A definitive, detailed, and relevant 
guide for network managers who have 
to implement TCP/IP networks. Included 
are sections dealing with Classless 
Inter-Domain Routing (CIDR), 
Multicasting, and IP version 6. 

(BTCPAD) Our Price $26 


MacPerl 


Power and 


MacPeri: Power 
and Ease 

By Vicki Brown and Chris Nandor 

This new introductory and reference 
work on MacPerl allows Macintosh 
users to gain access to this powerful 
and versatile language. 

An introduction to programming, using 
MacPerl - No prior knowledge of 

_I computer programming is assumed. 

Any competent and motivated Mac OS user should be able to learn 
(Mac)Perl from this product. Mac OS “Power" users should have no 
trouble at ail. 

(BPERU Our Price $36 





3-D Sound for Virtual 
Reality/Multimedia 

by Durand Begault 

This book provides a diverse group of 
research and development results that 
are appropriate to the developing 
technology of 30 sound as applied to 
virtual reality and multimedia. 

(BSOUND) Our Price $49 
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Far Macintosb 
Frogrammers & Developers 
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MAGAZINE 


MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with everything they 
need to know about software development. Topics like Rhapsody, Java. 
QuickTime. OPENSTtP, Objective-C, C/C++, Object Oriented Technologies, 
product reviews and much more! 

Subscriptions: 

(MTYRDM) US^omestic for 12 issues $47 

(MTYRCM) Canadian for 12 issues $59 

(MTYRFM) International for 12 issues $97 

Back Issues: each plus shipping (subject to availability) $10 




MacTech« CD-ROM Volumes 1-12 

• Includes Apple's issues 1 -29 (1990-1997) 

• Almost 1600 articles from all 139 issues of MacTech 
Magazine (1984-1996) and through may of 1997 

• Improved hypertext, improved indices, and a new THINK Reference Viewer- 
for lightning quick access! 

• New hyperlinks between articles 

• 100+ MB of source code—use them in your applications, with no royalties! 

• Full version of THINK Reference™—the wiginal online guide to Inside Macintosh. Vols. I-VI 

• 80M8 of FrameWorks/SFA archives and the most complete set of Frameworks archives know 

• Sprocket™! MacTech's tiny framework fliat compiles quickly and supports System 7.5 featun 

• The best threads fmm the Macintosh programmer newsgroups plus thousands of notes, tips, 
snippets, and gotchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much more! 

(SMTCD12) Volumes 1-12 Our Price $129 
(SMTCD12U) Upgrade from any previous version Our Price $49 



Inside Macintosh: CD-ROM 

by Apple Computer, Inc. 

More than 25 volumes in electronic form. Includes: 
QuickDraw™ GX Library, Macintosh Human Interface 
Guidelines, PowerPC System Software, Macintosh Toolbox 
Essentials and More Macintosh Toolbox. QuickTime and 
QuickTime Components. Access over 16,000 pages of 
information with Hypertext linking and extensive cross 
referencing. 

(BIMCD) Our Price $89 
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APPLE ENTERPRISE SOFTWARE 


Getting Started With WebObjects 

by Apple Enterprise Software 

If you're a first time user, start here to learn the basics of how to 
create and run WebObjects applications, 

(BGSWO) Our Price $14 

WebObjects Developer's Guide 

by Apple Enterprise Software 

A guide to building and understanding WebObjects applications. 
Takes a close look at the WebObjects scripting language, Additional 
sections explain the WebObjects architecture and tells you how to 
integrate your code into the request-response loop, create reusable 
components, create client-side components, take advantage of 
powerful Foundation Framework features, and more. Filled with 
example code. For all WebObjects programriiers. 

(BWODG) Our Price $16 

D'OLE Developer's Guide 

by Apple Enterprise Software 

Distributed OLE is avaiiable today, and this book shows you how to 
use it, Using real-world examples, ttie book steps you through the 
process of making your OPENSTEP objects available on Windows 
through OLE. 

(BDOLEDG) Our Price $22 

Discovering OPENSTEP, Mach 

by Apple Enterprise Software 



Object-Oriented 
Programming and Objective C 

by Apple Enterprise Software. 

An introduction to the principles of object-oriented programming in 
OPENSTEP and the official description of the Objective-C language. 
Objective-C is easy to learn and use because ft adds very little 
syntax to the C programming language. It's dynamic nature allows 
you to accomplish things not possible in most other object-oriented 
languages. For any OPENSTEP programmer. 

(BOOPOC) Our Price $24 

Working w/ Interface Builder (for eof) 

by Apple Enterprise Software 

A hands-on, award-winning book designed to help you get your job 
done with the updated Interface Builder, released with NEXTSTEP 
3.3 and the Enterprise Objects Framework 1.1. For any programmer 
using Interface Builder to design objects that truly work in 
NEXTSTEP, 

PWIB) Our Price $24 


Introduces programmers to NeXT's OPENSTEP 4.0 Developer product 
by guiding them through the creation of three appiicafions of 
increasing complexity. The tutorials demonstrate and explain 
programming techniques, Objective-C fundamentals, common APIs, 
and usage of the deveiopement tools. Along the way they present 
summaries of important concepts and paradigms. The book also 
includes a chapter directing readers to programming resources, 
further information, and services such as training and support. An 
appendix offers a concise discussion of object-oriented programming, 
(BDOSTEPM) Our Price $15 


Using EOF 2.1 w/ OPENSTEP (Mach & Windows) 

by Apple Enterprise Software 

Using Enterprise Objects Framework with OPENSTEP describes how 
to create an Enterprise Objects Framework application on 
OPENSTEP, It includes a tutorial and a chapter on creating a user 
Interface for an OPENSTEP Enterprise Objects Framework application, 
(BUEOFO) Our Price $14 

EOF Developer's Guide for EOF 2.1 (Mach & windows) 

by Apple Enterprise Software 


Discovering OPENSTEP, Windows 

by Apple Enterprise Software 
Discovering OPENSTEP provides an introduction to OPENSTEP 
programming on Windows NT. It guides the reader through the 
creation of three applications of increasing complexity. Along the way, 
it explains concepts and illustrates aspects of Objective-C, OPENSTEP 
classes, the development environment, and programming techniques. 
A short appendix offers a summary of object-oriented programming. 
(BDOSTEPW) Our Price $16 


The Enteqorise Objects Framework Developer's Guide describes how 
to develop database applications using the Enterprise Objects 
Framework tools and classes. It includes an architectural overview of 
the product, and descriptions of programming tips and techniques. 
An appendix offers a summary of Entity-Relationship Modeling, 
(BEOFDG) Our Price ^4 

EOF Developer's Guide for EOF 2,0 (BEOFDG20) Our Price $24 
EOF Developer's Guide for EOF 1 .x (BEOFDG1X) Our Price $24 
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Rhapsody 
Developer’s Guide 

by Jesse Feiler 

Covers the basic architectural principles 
of Rhapsody: the Mach microkernel, 
object-oriented programming, and the 
elements of a modern OS such as 
preemptive multitasking, protected 
memory, and symmefric multiprocessing. 
Also shows ways of getting to this new environment—Objective C, 
conversion tools, and the integration of Java—to develop Rhapsody 
products. Paperback, 450 pages. 


(BRDG) Our Price $35 


Be Developer’s Guide 

by The Be Developement Team 

The Be Developer's Guide is the official 
programmer’s reference manual for the 
BeOS, a revolutionary new operating system 
built around multimedia, threading, and 
multiprocessing. Essential reading for anyone 
who wants to design runnable applications 
for the BeOS, this book describes and explains how to use all the 
development kits, providing multimedia developers access to the 
Internals of the first new operating system in years, 

$45 


Interface Design: 

By Peter Bickford 

This book is a practical guide for designing 
software with users in mind, it offers an on- 
the-job view of what it takes to create great 
products, offering practical tips and advice 
instead of forcing the reader to extrapolate 
from abstract psychological theory. Interface 
Design targets a wide range of design issues, from taming the 
incomprehensible Interfaces of database systems and the Internet, 
to using sound and animation effectively in multimedia. Throughout 
the book, the author offers techniques for controlling the growing 
complexity of computer software, and makes an impassioned case 
for intelligent design based on the real need of users. 

(BifITTR) Our Price $31 


(BBEDEV) Our Price 


Interface 

Design 




The Java FAQ 

by Jonni Kanerva 

Java FAQ provides an insider's view of the 
Java’'^ technology by posing 
and answering the most important, frequently 
asked questions about the Java 
programming language, Java applets, and 
Java stand-alone applications. The Java FAQ 
is unique In that it draws from the tens of thousands of questions sent 
to <java@java.sun.com> and provides authoritative answers direct 
from the creators of the Java programming language at JavaSoft. 
(BJFAQ) Our Price $25 






Check out our Web site! 

• Full product descrfptItHis • Hundreds of more products 

http://www.devdepot.Gom 


The OpenGL 
Programming Guide 

by Mason Woo, Jackie Neider 
and Tom Davis 

• Coverage of the new features of OpenGL, 
Version 1.1, including all texturing changes, 
vertex arrays, polygon offset, and RGBA 
logical operations 

• The incorporation of the OpenGL Utility Toolkit, GLUT, in all 
programming examples an overview of the OpenGL rendering 
pipeline and state machine 

• Enhanced coverage of polygon tessellation, quadric surfaces, pixel 
operations, and error handling 

• More performance tips 

• A greatly expanded index 
(BOPGL) Our Price $39 


AppleShare IP: 

By Tom Dell 

This book is for administrators either using or 
planning to use Apple's new networking 
system. The book discusses choosing 
servers, configuration, access privileges, the 
AppleShare file server, print service, e-maill, 
web services, Apple Search, MacDNS and 
interfacing third party products, 

• Discusses choosing a server and the AppleShare file service 

• Cover AppleShare IP support for PCs 

• Addresses AppleShare IP e-mail, web and print services 

• Includes hands-on exercise and one CD-ROM for Macintosh with 
and AppleShare IP Administrator’s Toolkit 

(BSHARIP) Our Price $35 

Effective C++, 

Second Edition: 

50 Specific Ways to Improve Your 
Programs and Designs 
by Scott Meyers 

Effective C++, 2nd Edition includes; Expert 
guidance on object-oriented design, class 
design, and the proper use of inheritance 

• An examination of the standard Ch-t library, including how the 
Standard Template Library and classes like string and vector affect 
the structure of well-written programs 

• Discussions of late-breaking language features like in-class 
constant initializations, namespaces, and member templates 

• Wisdom usually possessed by only the most experienced 
developers 

• Effective C-i-f continues to be essential reading for every 
developer working wibi C+-r. 

(BEFFC) Our Price $34 


Effective 0+ 
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DeBabelizer 

by Use Oespres and Paul Vachier 

DeBabelizer: The Authorized Edition is the 
official guide for Web designers, 
multimedia creators, artists and production 
specialists who want to take advantage of 
this powerful tool. 

• Create graphics and images for the Web that download fast and 
look amazing 

• Optimize graphics for CD-ROM. video, and animation 

• Optimize and manage colors using the SuperPalettefTM) 

• Discover DeBabelizer tips and advice from industry experts 

• Master basic manipulation techniques, including rotation, Mating, 
cropping, and text overlay 

• Explore key production techniques in all areas of graphics 
processing 

(BDEBTAE) Our Price $39 

Symantec Visual Cafe 
Sourcebook 

by Cary A. Jardin and Pam Dixon 

Symantec Visual Cafe, the first visual Java 
development tool that gives programmers a 
sophisticated set of tools. This book teaches 
programmers how to use Symantec Visual 
Cafe to create Java applets. It provides a thorough introduction to 
the language and gives advanced Java programmers information on 
how to use Visual Cafe to create their own Java development tools. 
(BSYMSOUR) Our Price $35 
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Designing 3D 
Graphics 

by Josh White 

In this powerful book/CD-ROM package, 
top computer graphics artist Josh White 
tells you everything you need to know to 
create sophisticated reai-fime 3D 
graphics for computer games and virtual 
reality, This book contains the in-depth 
knowledge of software tools and hands-on modeling techniques that 
Josh White has learned while creating artwork for over 20 
commercial games, including Descent, Zone Raiders, Locus, 
Legoland, and others. 

(B03DG) Our Price $35 
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Teach Yourself Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L. Perkins 
with Timothy Webster 

Add interactivity and muftmedia to Web pages! 

A step-by-step guide to make your Website 
come alive. Learn the basics of programming 
Java applets and the concepts behind the Java language. Includes CD- 
ROM with a limited version of Roaster, the first commercial, integrated 
applet development environment for Java for the Macintosh! 
(BJAVAMAC) Our Price $36 
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Linux Configuration 
& Installation, 

Srd Edition 

by Patrick Volkering, Kevin Reictiard, and 
Eric F. Johnson 

Linux, the leading UNIX variant, has garnered 
toads of attention within the UNIX community. The 
amazing thing about Linux is that you don’t need a workstation to run it. 
Linux Configuration & Installation, Second Edition lets you run Linux 
today. Program with Linux using C, C++, Perl, and Tcl/Tk. The 2 CD- 
ROM pack offers one of the most popular Linux distributions, Slackware 
96, and comes directly from Patrick Volkering, the creator of Slackware. 
(BLC12) Our Price $35 

JavaScript 
& Netscape Wizardry 

by Dan Shafer 

The perfect book to show you how to turn 
Netscape into your own personal, customized 
operating system. Provides the inside tips 
and techniques for making your Web pages 
much more attractive. Shows you how to use 
all of the key features of the JavaScript language, Including objects, 
methods, properties, events, and much more. Includes CD-ROM with 
numerous interactive scripts written in JavaScript you can add to your 
Web pages today. A complete set of the best Java applets. Useful plug¬ 
ins designed to supercharge Netscape and resources to help JavaScript 
programmers. 

(BJNWlZ) Our Price $31 
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The Java Class Libraries, 
Second Edition, Volume 2 

by Chan Lee 

This book is Intended as a reference rather 
than a tutorial, Its format is similar to a 
dictionary’s in that it is designed to optimize 
the time it takes for you to look up 
information on a class or class member. The 
classes in this book are ordered alphabetically wiflnout regard to 
package name. This makes looking up a class as straightforward as 
looking up a word In a dictionary. Each class is described in its own 
chapter. Each chapter contains a picture of the class hierarchy, a class 
description, a class example, a member summary, and descriptions for 
every member in the class, 

(BJCLASS) Our Price $44 



Increasing Hits and Selling 
More on your Web Site 

by Greg Helmstetter 

Written especially for entrepreneurs, 
corporate marketing managers, small 
business owners, and consultants, this 
valuable guide gives you rare tips and tricks 
you need to know to make your site a commercial success. 
(BIHSMWS) Our Price $22.45 
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Programmer’s Toolbox 
Assistant CD-ROM 

Instant electronic access to 
Inside Macintosh essentials, 
by Apple Computer 

Get quick access to reference pages for over 
4,000 Toolbox calls in your system software 
from their development environment. Essential 
information for Macintosh software developers, Hypertext links allow 
programmers to view related topics easily. The ultimate elecfronic 
reference tool for Macintosh programmers. 

(STBASST) Our Price $89 
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The Official BBEdit Book 

by Bob LeVitus and Natanya Pitts 

The Official BBEdit Book makes it easy for 
today's Webmasters to speed their own 
interactive development projects using this 
powerful editing environment. Bare Bones 
incorporates features like floating palettes, 

'■ HTML support, and syntax coloring to 

enhance an already extensive feature set, making BBEdit a leading 
Web authoring tool. Super-fast text processing, easy scripting, wide 
extensibility, strong GREP-style search-and-replace capabilihes, and 
support for 13 languages make it easy to see why so many Web 
developers use BBEdit as their primary authoring tool. 

(BOFBB) Our Price $35 


The Official 
BBEdit 
Book % 



HTML ForTheWorid 
Wide Web, 2nd Edition 

by Elizabeth Castro 

Teach yourself Hypertext Markup 
Language the quick and easy wayl This 
Visual QuickStart Guide uses pictures 
rather than lengthy explanations. You’ll 
be up and running in no time. If you 
need to learn HTML fast - this is book 
is for you. 



(BHTMLW2) Our Price $16.15 


Macromedia 
Shockwave for Director 

by Jason Yeaman and 
Victoria Dawson 


The compiete resource for creating 
Shockwave movies on the Web, This 
hands-on reference makes it easy to 
create Shockwave movies and put 
them on the Web. Expert tips from the 
creators of Macromedia’s first 
Shockwave movies, together with detailed examples and instruction, 
provide everything you need to get started. Includes CD-ROM. 
(BMSFD) Our Price $27 


Getting Hits-The 
Definitive Guide To 
Promoting Your Website 

by Don Sellers 

Getting Hits explains in easy-to- 
understand language the underlying 
concepts behind the art of Web site 
promotion. Just a few of the topics 
you’ll learn include: using search 
engines with URL’s; finding related Internet groups or lists; 
understanding the nuances of click throughs and ad rates; and 
distributing press releases to key Internet contacts. With this book, 
you'll go beyond the conceptual and actually follow real-world tested 
promotional campaign strategies. Bring the world to your Web site! 
(BGHITS) Our Price $17.95 




Optimizing PowerPC Code: 
Programming the PowerPC 
in Assembly Language 

by Gary Kacmareik 

Take full advantage of the potential of the 
PowerPC by mastering the Assembly 
Language techniques. Learn to produce 
faster more robust software! 

(BOPTPPC) Our Price $35 
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JavaScript For The 
World Wide Web 

by Ted Gesing and 
Jeremy Schneider 

This book takes an easy, visual 
approach to teaching JavaScript, 
where pictures guide you through the 
software and show you what to do. 
Works like a reference book, you look 
up what you need and then get straight 
to work. No long winding passages, concise, straightforward 
commentary explains what you need to know. 

(BJWWW) Our Price $16.15 





WebMaster in a Nutshell, Deluxe Edition 


by O'Reilly & Associates, Inc. 

Cross-platfomn, completely portable, and lightning fast, 
the CD-ROM Is an invaluable addition to the 
webmaster's toolbox. The CD-ROM contains the Web 
Developer’s Library—the full text of the latest editions ot five 
popular O'Reilly titles: "HTML: The Definitive Guide, 2nd Edition"; 
"JavaScript: The Definitive Guide, 2nd Edition"; "CGI Programming 
on the World Wide Web"; "Programming Perl, 2nd Edition"; and 
"WebMaster in a Nutshell," The Deluxe Edition also includes a 
printed copy of "WebMaster in a Nutshell," the all-inclusive quick 
reference that belongs next to every webmaster's terminal. Includes 
CD-ROM & 356 page book. 



Requirements: The CD-ROM is readable on all platforms, but requires 
a web browser that supports HTML 3.2, Java, and JavaScript. 
(BWMNLITD) Our Price $62 
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CodeWarrior Software 
Development Using PowerPlant 

by Jan L Harrington 



Check out our Web sitel 

: • Full product descriptions • Hundreds of more products 

http://www.devdepotcom 


C++ programmers will learn to develop object-oriented software 
applications (or the Mac and Power Mac using the PoweiPlant 
environment and the classes that support it. Covers CodeWarrior 8. 
Included CD-ROM contains source code for all the programming 
examples in the book and Metrowerks CodeWarrior Lite. 

(BCWSWDEV) Our Price $31 




JavaScript 1.1 
Developer’s Guide 

by Arman Danesh and Wes Tatters 

Written by developers for 
developers. An advanced 
guide to creating 
professional Web 
applications with 

JavaScript 1.1 as deployed in Netscape 
Navigator 3.0, Microsoft Internet Explorer 3.0, and LiveWire. Includes 
CD-ROM with Sun's Java Developer’s Kit. JavaScript and HTML 
Editors for Windows and Macintosh. 20 contributed ready-to-run 
JavaScripts and JavaScript examples from the book. 

(BJSDG) Our Price $44 
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Debugging Macintosh 
Software 
with MacsBug 

by Konstantin Othmer 
Jim Straus 

MacsBug. from Apple Computer, Inc., 
is the leading debugging software 
program tor the Macintosh. This 
book/disk package is an all-in-one kit 
for using MacsBug. Chapter 1 introduces MacsBug and describes 
the contents of the rest of the book. Chapter 2 describes how to 
install MacsBug and enough low level details about the Macintosh 
so that you can use MacsBug. Includes MacsBug 6.2 on disk. 
(BDMSWM) Our Price $31 
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Wireless For pijffl 

The Newton W’-'-i 

by Julie McKeehan and Neil Rhodes 

A book that picks up where 
Programming for the Newton left off, 
teaching the reader how to develop 
Newton software on the Macintosh. The 
enclosed floppy disk provides a sample 
application, as well as a fully functional 
demonstration version of Newton Toolkit. 

• Learn to develop Newton software on the Macintosh 

• Hands-on Newton environment training with sample code 

• Includes disk with sample source code for a Newton application, 
^ well as demonstration NTK - the complete development 
environment tor the Newton 

(BWIRELESS) Our Price $31 





C++ Programming 
with CodeWanior 

by Jan L. Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles. Leam 
object-oriented programming techniques 
using C++ as the example language and 
Metrowerks and CodeWarrior as the example 
compiler. Enclosed CD contains example code from the book and a 
full-function Metrowerks CodeWarrior. 


(BCPPCW) Our Price $33 


S Leam C on The 

Macintosh, Second 
Edition 

by Dave Mark 

New revised edition! Easy-to-understand - 
everything you need to start programming. 
Updated and enhanced exercises that lead you 
step by step. You’ll leam function, variables, point datatypes, data 
structures, tile input and output and more! Includes CD-ROM with 
Metrowerks CodeWarrior'^'^ Lite. 

{BLEARNC2) Our Price $33 

The Way Computer 
Graphics Works 

by Olin Lathrop 

A complete guide to mastering 
computer graphic basics. It is written 
in a frank, down-to-earth style 
covering everything from how 
computer graphics are different from 
fine art and photographs, to modeling, 
pixels, and the principles ot animation. 
All of this is done without resorting to mind-numbing equations and 
impenetrate technical jargon. 

(BWCGW) Our Price $29.65 

Inside PowerPlant 

by Metrowerks 

Create PowerPlant applications using the CodeWarrior IDE and 
PowerPlant Constructor. Full descriptions of major PowerPlant classes 
and resources. Included are the PowerPlant Constructor Manual, 
including View, TextTraits and Custom Types editing, and PowerPlant 
Library Reference, covering all classes and functions in PowerPlant. 
(BINSPP) Our Price $34 
SEE RELATED CATEGORY: Dev. Environment 
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AppleScript AppleScriot 


AppleScript Language Guide 

by Apple Computer, Inc. 

A complete reference for anyone using AppleScript to motlify existing scripts or to write 
new ones. Contains useful information for programmers who are working on scriptable 
applications or complex scripts. Features detailed definitons of AppleScript terminology 
and syntax in toe following categories: Value classes, commands, objects and 
references to objects, expressions, control statements, handlers, and script objects. 
Includes many sample scripts, discusses advanced topics such as writing command 
handlers for script applications, the scope of script variables and properties declared at 
different levels in a script, and inheritance and delegation among script objects, 

(BALG) Our Price $26.95 
SEE REUTED CATEGORY: Scripting 







AppleScript 

Applications: 

Building Applications with 
FaceSpan and AppleScript 

by John Schettino Affiliation & Uz O'Hara 


Build complete AppleScript applications using 
FaceSpan, a user interface development tool 
that makes AppleScript applications truly 
“Mac-Like", Uses a step-by-step approach 
to demonstrate techniques for building 
applications through illustrations and 
samples. Provides Graphical User Interface 
(GUI) design tips and practical approaches for 
implementation. Contains one CD-Rom with 
AppleScript 1.1, a demonstrafions version of 
FaceSpan 2.1, source code for all example 
applicahons numerous AppleScript shareware 
and demonstrations programs. Contains a 
section on debugging AppleScript 
applications using FaceSpan. 


m ^ ... 
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Special Edition 
Using CGI, 

2nd Edition 

by Jeffry Dwight, Michael Erwin 
and Robert Niles 



Ssikrtntt Edition taUE 


This complete reference provides 
professional Web developers and advanced 
personal users with the latest information 
on using CGI (Common Gateway Interface) to interact with databases. 

• Explains client and server uses of CGi 

• Provides extensive coverage of live audio and video feeds, user 
chat and interaction, and CGI security 

• Features separate chapters devoted to language-specific lips, 
tricks, and traps 

• CO ROM is loaded with the HTML and CGI sample code from 
Ihe book 

• Includes applications for guest books, mail and new gateways, 
browser identification, access restriction, and shopping carts 
(BSEUCGI) Our Price $44 

JavaScript for the Macintosh 

by Matt Shobe and Tim Ritchey 

Allows non-programmers to take 
advantage of the power of 
Netscape Navigator. Expand toe 
capabilities of your Web page, without 
having to understand C or C-i-t-. CD-ROM 
contains "Wiziets" that allows you to easily 
create your own JavaScripts. Takes you step-by-step through 
programming cross-platform JavaScripts. Details how to create 
JavaScripts for JavaScript-aware Web browsers. 

(BJAVASCRPTJ) Our Price $40 



jAVASCRiPT 

FOR Macintosh 


(BAPSCAP) Our Price $31 


Java in a Niitsheii, 2nd 
Edition 

by David Flanagan 

A detailed overview of all of the new features 
in Java 1.1, both on a package-by-package 
basis and in terms of overall functionality. A 
comprehensive tutorial on "inner classes" 
that explains how to use all of toe new types 
member classes, member classes, local 
classes, and anonymous classes. Practical, real-world example 
programs that demonstrate the new features in Java 1.1, including 
object serialization, toe new AWT event handling model, 
internationalization, and a sample Java Bean. 

(BJNUT2) Our Price $17.95 

AppleScript Finder Guide, Engiish Dialect 

by Apple Computer, Inc. 

Provides definitions for Finder object classes and commands. Write, 
record, or run scripts that trigger toe same desktop actions that you 
trigger using the keyboard and mouse. 

(BAF6) Our Price $17.95 

SEE RELATED CATEGORY: Scripting 

Inside CodeWairlor Professional 

by Metrowerks 

Includes CodeWarrior IDE User’s Guide. This is toe printed version of the 
documentation provided on the CO. Covers CodeWarrior Professional 
Release, the debugger and associated tools. 

(BINSCWP) Our Price $34 

SEE RELATED CATEGORY: Dev. Environment 
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3D Graphics 
Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 3D graphics into 
your applications. Explore QuickDraw 3D, 
a revolutionary graphics extension to the 
Mac OS for Power Macintoshes. CD 
contains the complete QuickDraw 3D 
system itself and a complete database of the QuickDraw 3D API, 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine. 8ook/CD-ROM, 640 pages. 

(B3DGRAP) Our Price $35 



Advanced Color Imaging 
on the Mac OS 

by Apple Computer, Inc. 

Enhance your software's color 
capabilities with step-by-step 
instructions. Augment the color support 
supplied with QuickDraw, and QuickDraw 
GX. Use the Pallette Manager to get the 
best colors on limited displays. Match 
colors between screens and input/output devices (scanners & 
printers). CD includes a complete reference infomiation in both 
QuIckView and Acrobat formats. Plus, a sample application 
demonstrating ColorSync programming techniques. 

(BADVCI) Our Price $33 




UKiii ibi fctlmviri In Ytv Uw n 


THcks of The 
Mac Game 
Programming Gurus 

by McComack, Ragnemalm, Celestin, et al. 

For beginning to expert game 
programmers. Complete overview of all 
the necessary components of game 
programming on the Macintosh. Packed 
with valuable tools, utilities, sample code, CodeWarriorT'^ Lite and 
game demos. QuickDraw 3D and Power Mac optimization and inside 
info on how Gfypha III was created. Hundreds of tried-and-true 
tridrs, tips, and insider secrets from well-known Mac game 
programming experts. 

(BTRICKS) Our Price $45 


. . ’"X 

BUckArlof \ 

MACINTOSH^ 


MHSBflllE*® 

GRI1E 
P 


GAME 

PROGRAMMING 


Black Alt of Macintosh 
Game Programming 

by Kevin Tieskoetter 


Develop your own 3D games in 


* 

S- hlVkhf !'I .■'MilFj«!tt ^ " 


C on the Mac. Includes CD with 
project files for both Symantec 



C and Code Warrior. Create 
freefomn texture-mapped games and 
polygon graphics. Control dynamic source 
code—all compatible as native to the Power Mac. Write directly to 
the screen, bypassing QuickDraw. 

(BBLACK) Our Price $35 



Here are more products. For full product descriptions please see our 
Web site, or feel free to call, fax, or E-mail us. Our prices on books are at 
least 10% off list price. 


PRODUCT 

bcvclopmcnt Environments 

CODE 

PRICE 

PRODUCT 

CODE 

PRICE 

/tpplaSaipl Atfpiksdioitft Ikikln0 Appicasois wiFsceSpan. 


, ,.,,. .$31.00 

Taligait's- Gmtic la EJcEigning Programs . 

DTALIGBiT 

-. um 

Ci-F Programmirta .. . . 

. 

.,,.31.00 

Tl» fif Prrign^i npX.. , , 

. 


rJT^* STK Jkflf'fi Gidit 


.HiSI 

Vlsuai Pro^Timiiip widf ProT^plT CPx. . 

_flusm 

. 30.00 

(:od«WArilar kisMie _ _ 

Me9i> 

.34iD 

for The Nuwlon. ,,, „., 


.. 31.00 

Pmgnsnnwfs KM 

Hfflwwinf: 

.J4jOO 




Uan Sififer Pressnta Pie Power of Ptnguipii CPX ...... 

.BDfWPfla- 


Hardware 



kBibe ODdeWamor Booh ...... .. 

.,BHSCW. 

.34.00 

AGDie CO-nOM ttandtwofc.. 

.eCDHAf^. 

.14JI6 

instant COIftlA............. 


.17,99 

IJeSiflntnp Cartia & l^lmrs for thfl Mariiit[^ ... 


. 2BM 

Last Rsaoit HrogrammBts Edition....... 

.... 

. BUStHSKI,,,,. 

..74.00 

LaserWriter Itef ereoce......... 

... 

.BlASERfitP 

.17.96 

Maclrttodb C PnjQrammlflp Primer Vofuma ... 

.flCPfilMl 

_ 2A^ 

PQ EJya,1iBm iVchltecture 3Td Edition...... 

.BfCISVS. 

...31.00 

r PiT^orai^l*V| Prim^Vnlfif^ .n.n.n,,, 

ecpfiiwi2 .. 

. .Z4.2S 

Powerix; Afcfiiit!^^ ... ... ... 

. BPPCAfiCH . 

. 31.00 

UnrvtffKh Pmrfll PmrjrriAimln]] Prinw Ucih nn* 1 

BPASCPni 

24^ 




Mastornj ttu ^tlnh Class ... 

— BMASTorra, 

msb 

Internet Related 



M»diirir«j llw* Tnohn Lbang THIliC C _ _ 

finmi9 


IriflmM WMA . 

. 

.. ,^,95 

rtrlHftwj Prrayaminln^ ................... 

- a£3flJC00Pr>«H^ 

.QPfrSMAGIC.^.. 

,,,,, 34nn 

tohEJawa ... ....... 

nAOT.IMA 

23JB 

PirpsKnlijiq Ma^cC^i___,,___ 


America Onine tor Uummies _.... .__- 

(untfiii 

17.05 

Real Wmkl ... .... 

. . QRTAl Win, 

.35J00 

DGl% Fomplb .,.... 

maup 

.......31IB 

SymaoEecCi I httgmrrmiing. .... 

.J3SVMCPP..™. 

..39,00 

Btiildiiho & MpIntiilnlFig an Intranet me 

.....BOAMAt.. 

...45.00 


Web site: hftp://www.devdepot.com • E-mail: orders@devdepot.com 
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HOOKS AND KEFEKEIVC] 




l3DfT(jiitBr . ... 


__ 32JS 

De«toplnQ OGI Aocfcatiore with Ptri..... 

.. WCQk .... 


F.lWsyi Hawnd^tn 

K+UAI^ 

.22.45 

EisfraritG Of E’Mall _____ 

..BEMAl.. 


HmloBd on Jawn _ _, 

.BKJttffll,!... 

.26j95 

^islarn Intumol Guido. _ .... . 

..BWSTWT 

.13.45 

WEfnet Book. ....... 

...Bn©€T. 

. 22^0 

kitnmiA lir rttrmniK _ in , 


1799 

lilEfTi(S fw Dumrr^ tliiri Ri4afMv^, 

.. 

RntMnrK 

11 fK 

lni 0 TK^ ftr Macs for Duinirries.................. ..... 

..DNETDUM............... 

17 95 

tnlEsriel fm Maos tor DumiiMsBeslsellerEiltllon,........^................ 


S&fKI 

Irtfifiiel Pnwrtf Tools....... 

... 

.ePWHTOOL... 

.36TKI 

kihumrtt ftirtfihIfiQ with ....,.. 

....,.BPWAA 

.3GJ0Q 

InliwtKl Thd, fkeknn Ritlrvi . 

BMFmPItK.. 

.31 .oa 

Web Dev.: Eittsrpriss Ansrii&llVGS to Clcrrt/S£rv 9 ..... .... 

Hunan , , , 

44ira 


BJAVAESSPI 


Java In a NOtehei..... . 

.BJAVANUT.... 

.13.45 

Jawi iJinflLrtja API Suwfflihfe..... 

HJIAS. ... 

.53.0Q 

Java Progranunlno Mflli COBfiA. 

.&JPWC.. 

.26,99 

.fava^ivinf r4Mif(lK)rih 

BJSC 8 . 

..44410 

^^vaSoif* tw Mndmndi . 

..BJAMASCRPT.-. 

.40,00 

Leom HTM(. ^ fie _ 

.BLHTML..., .. 

_a.95 

1 fBin .tavn m Ihn MncvilrKp .,,.... 

..a JAVA. 

.31.00 

Mastering hkuscape ?-g fur Mootnioshr Second fedillon.... 

.BMASNTT?. 

...36.00 

Measuring the bipacl (if Web Site.......... 

.BMm/VS.... 

..20.iS 

Mere Intemd fa Dunmies Siader Kl........ 

.JffiOMNTT^. 

.1T.S5 

Mosaic for TJummiBa...... .. 

_ 

..17.99 

ns«i 

. RU^mHAT. 

....... 17,00 

_45.00 

Fustet Harrfbook......... 

..flNETOFH... 

Peii Quck %fefHx:e..... 

...„.RPffliRFF... 

.17.99 

Ranring arid Managing Wetjsites..__..... .. 

.BPLANWtB.,....^_ 

35.00 

PnJftiei V 55 uf IViwni^ on tlw Intfifnor ....... 

........... BPVP............... 

26.99 

ProvMng tniemet Services via Die MaeCS 

__..BPfWVHfcl 

.,,31,00 

PiriWiefiriitinrtwi 

KWKHnn 

__31.00 

TCP^WIIW)l7Bimie _ _ 

.. .BTCPi^GlVtX 

mssQ 

Teacii WxiTseit Java In 21 days_ _____ 

.iWAMAMAC.. 

.. 36,00 

Tlw Intflmst Martsetlng Plan ...... ... 

UTIMF 

35.00 

Ttie InleiTiet Sirategic Plan.... .. . 

.BISP, „ . 

.2245 

TM Web fuiviQBiff ..... ....... 

.. Sim. .. 

.2245 

UndHiraund Gmdo lu Triemnentjlpg,,.. 

.BUNOfR. 

.22.45 

tlsingl neiKlUre^nf^aK gm krirHTwt , ___ _,_^_, rr , 

, fujh 

40.00 

WpJi EVufttifs Tfris enl Tisdifiif|igH. 

..BWGTT. 

35,00 

Won hojifl Mnn fiiiiiio. . 

...GWEBIIFAD.. 

.22.45 

WbtJ Markfltiiig CoiMuxA........ 

.„„„..BWMCH... 

.35,00 

Wee Page Scrijiing Todinlqges ...... 

.eWEBPST ... 

....45.00 

w ^9 PufaintiH's Olesgn fiiiirjfl fiT UfKBilmtl ?ncl Pritim.. 

nwptiR? 

35.00 

WfetiPijhfcdhkig,, __ 

...™.JIWPWAA.. 

.35,95 

W^ Sailurlty SarcifaoDtc_ _ 

.... , fJWFfJSFR. , 

26J9 

Web WteKtog.... 

.......JWWEAV. 

22.46 

Wabnisster Madritaati............. 

.BWPBm'3. 

. 3fiHS 

Scripting and Solutions 

APdieSenpt AdODcatioris: BiAfng Aff^i min faceSpan.. 

bapscap. 

.31.00 

Solfitkig UditHK & .. 

fKaum. 

, .17.05 

Apfilleo .,,. . 

Wkppifn 

..31.00 

CoinpiBto HypofCaidP.P libird .. ..,,.. 

.awpcrti? .. 

.,31jf» 

Comptota HyperTalk 2.2: ... 

..BKypcim?. 

.31.00 

Danr^ Goodman^ Apfile Guide Siarter rat,....... 

.EDGAf^ ... 

..31.00 

hlyiKrf^djbndi.. 

rtw^A 

.19,95 

J;|»ii3LSrr5!ri r« _ .. _ 

..... RjymSCflPT.. 

.... 40.00 

Perl llodi ... 

fiPRlIlT 

,„_17.99 

Real ItorM Annie Guide... 

_ RflCMM . ... 

.. 35.00 

Technical Reference 

Artiwi .la«fl . 

. HAHTUMM 

. 23M 

ApfM m-FKM HairitHVc .,.. 


.14.36 

Mof Hiinsn IntfldArx Itofi^ . 

.. .sum.. . 

.20.05 

Aedi Art pt Mac tJerna Prngranmig........ 

R«ACK 

.35.00 

BiAling An bonnec: Cdnnert Tour (ntrawi wiiN Vleridofu and Custoneer. 

C++(erUuinmiea,. . ...... 

..BSU3£Xr„.. . 

.Hnppiiiui. 

26.00 

. .2246 

C tor Dumrrrtot UbI. 1. .. . 

..BCOUM.. .. 

.17.95 

Developing Otipcl Oienled Snfiwsm fnr me MadriiosN.. 

Boevoe.. 

.. J6j06 

ExtOTHSiig Die IMk Tooftxai .. 

.betmt ... 

. .2246 

FauridBUcrts ol MMrmtmli ^ _ 

..BFOtl®.... 

..,.35.00 

Fnjgrrioirt ■of Vbui ImapiiirKiri. .. .. 

..._.B=RAG .... 

.......as.oo 

GoKte ID Miicinttiflti Soflvvafe Localzaibon. . 

..JLOCALIZ 


Glide to MacintosN Sy?tl)em .. 

.GSYS7.5. 

.2250 


iTHfls AfipIflTafc _ 

. RAPTAIK 

.ai.oo 

ifBilriB me Mjicir4pgb C^ynrnuTiicaiMns TwHbw; .,»« 

Hnuu 

.22,45 

taserWtltiff Hetefafice... 

n 

...*...1756 

Lnam C++or Ote MacintosN... 

....HJWCPP. ... 

. SSJOd 

Leafn C w me Madniosn. ist EdtOon.... 

nuittni 

.31:00 

Learn C esti ttis Madntofih, 2nd Edrljon........ 

fttPAAMi!? 

asin 

Mac Progfaniiiwrig for Dumttite... .. 

RMMmiM 

J7.95 

MacliosN CProgramriiGrPrirTioriMiinw .... . 

. ... .....JCPHilll . 

. „24.2S 

Macintosh c Pfo^ammer PrinuIfejprwt?,, _ 

..,„..Bcpnoic. 

MPS 

Macinto^ DtF2 pnig, RdWwKx Worldng wttfr .. 

aniFp 

..4fLOO 

Maontosli Pascal PTofliamrnlng Primer WDhime 1.. 

...SPiOTra. 

.24.25 

MaoJilDsii Pnjgrammlrjg Secrels 2M edition ... 

..JQPSECTET.. 

.ZB*7B 

Marximsti Priigrammlng TfldNni(|[^ 

npTrQ4 

.31*00 

Mcmsil Visual Ji-+ 14 SoiratooK.., .. 

. .—BMVJS.. 

3^ OP 


Runnpi^ 

34.00 

Nk!hwyk fimrifya Ibindp . 

BWTFR. 

.. .59.00 

Nfivirtwi Programnning' Gida... .. 

RM-WlPtaitl 

.4aoo 

Ofcjfld Orterited Priogramrnlrio Des^ ..... 

.... .....eOOPROOtS , , 


Ofrtunlrirx] PnfyyftrPC Tjrti? ,.„.„.. , 

....BDPTPPC,.. 

.. 

35j00 

Pnd tluiek Fl«irafRfti» ____ 

...jPeiJ€F,.,....... 

.17.99 

Rf^nmnrfl 

RP^MWFF n 

pqftB 

PriHirtJOOfc Diaital Nomad's Guida -... 

....aPSTDNG....... 

.2246 

PiTi(pinmw^ Tn^ __ _„ 

*wtm 

.,40LO0 

l^rBCttcal Otioci Orlertod Devefaixfiistit In C++ and Java. 

...0POOD. 

.3190 

l^raHTunlng Inboduclion la Ifw Macintosh Famiy.. 

......aFAMii.y. 

..2246 

Programming tor System 7... 

..BSYS7... 

..24.25 

ProofarmnlnB wtBi Ai^loik....................... 

..BPROAT..... 

2245 

OuckTnnc Gitte tor Mectotagh Users-.-™_ 

.^ .BOrauDe - . 

.45,00 


riPFAiwin 

_35jOO 

ftesFiStMlMghtDtiwr^..... , _____ 

MtPSniM^ 

.2246 

flfaiFdtl Cmniilae. 2nd BIton....... 

...BRESEDS... 

.31.00 

RtHsFdil Rftfarence .....,........o. ..... _ - ... 

.......BRESEDflEF. 

26.96 

.^tnllMsirn hy nesJgrr nrf»lln{] FfjAfutty Kftftwaffl.. 


.26.95 

SyiTianlBC C++ lor tie MadnOHli llie Basics... 

.... 

. .ssxmm 

.51.00 

^adi yburseff Maonlosh C++ to 21 Days.-... 

.......... _,JCPP21D. 

.MW 

■fisdnical Nroduceen lo tw MactntoeN FanBy. 

.BlflTi#.. 

2428 

Tog on Software Design.... .. 

. JT0G„^»hh.. 

20.95 

Wriling Locaiiai^ Soriwaie..,,,.... 

.BLOCAL. 

.2425 


MisceHaneous 


3D Graphics lips* IridQ, 6 ..... 

..„B30Gm , ... 

„™21.00 

AHikgtiiera Irriagifvctiai .. 

, RntAG 

^-*.25.00 

Adobe Pramiero tor Die Maottojsli.... 

..BPREM.. 

.44.00 

Amanrii {inline Icr Dununiipq... .,,, , .. 

.BAaHUM... 

.17.SS 

ApptoGuldo Contolefe...,„„... 

..imK).. 

.35.00 

Art of Kimar Intcrfactf ITwdy]____,, .. 

mwi 

. 3S.TO 

CD ROM Gttiile In MiAUnwIto Aiririririi]{]i , . 

.. JCOMUJl . .. *-. 

.40 DO 

rjVnp^iTwtni FiiiniiiiiK 

..HSOUM. . .. 

1TJ5 

t^yheriiiiikllaiidhnnk.. , 

PcviV4l4t 

.a.95 

ncifitiy RnruIrttiifB'* Afifite Tn >irlR .'^lartw Ktl . .. 

.—0OQAOSK. 

.3Ij00 

Hanny IkjQdfTian^ Madniosh Hand^ „. —. 

wainriHH 


FrarttoWorte Souniie Code Disk ... . .. 

.,.,.MIPWSC. 

M 

.,9.95 

FranteWorks MagaEtoe flsdt . , .. 

...JItfVVSAjOK. 

.6*00 

Gra[iHk: rdwi^ 3 

RGFhfSP 

44.00 

GniemRG«m4 ,.... 

.0GEMS4. 

.4400 

rifllflilbT tlflCIH V ,,, _^_ _ rr_ r r ,r 


.4400 

litoi 1 ^Hfl'«^^^P■ri . r..„„n 

..BINFDRFV... 

.*.*«4aoo 

Insids Uvsctbr 5 with Linflo for MaoiiiliKfi .. 

..SIDSWIM,,-.. 

.44.00 

1 MA Mghtr urftti Marl-fcifli 

JBLATT.. ... ... 

,,,,26195 

MfK; PfflfNfrttirn R^!!irk-r ,, , , _... 

. BBfim .. 

.11,70 

Maerranctia Otecto Ltogo VAxkshop. and EdfBon__ 

.DMOtW?.. 

40.00 

MacSciits*«j:TteUilfflaifi Uidnioth Supenmafor^i K6. 

. .-BSCieW -- 

^,.-31,00 

Mflcintlfish tiiii'ss .___ .. .... 

r™^ 

.. 26,95 

MacIccN Ba£:k IssiMsa*.. „ . . 

..MTBACKISS. 

.10.00 

tWwwiiltS Uliiriiate Macintosh Piotpramming 

.SULTMAC. 

_ 35,{l£l 

MAnArtfiM tn moiniyi 

...*.. .....5HAOA83* 


Muiiimedla AuthoriNg: Buiittng and Devetoptog DocMmwta..... 

.BMMAUIH... 

.21jD0 

MuHiinedto StsiBr KS tor Macmiosh..... ... 

... BMMSlAffT. 

.. -27.00 

Pvndl hom &tperien05.. ,111,1,1111' ■ ■■ ■■ ,1... .1 

OPKVTT 

.2245 

RfisEdtl Compfete, Second fcdlson ....... 

.BRESHffi. M 

.31.00 

M(Kp, RcirnlK and 1 lisoRlro?; ..,.,. , 

ftSADMAr. 

.22.45 

Standantfi. Hjt Online CommufilcallDn. . 

PSF(1f^ __ 

..40.00 

Thu Rpmprth fir I^.Mall 55tyln . 

..9FMMI , 

.....13.45 

Hie Soltwaie Devetooer^ & Matodu^ 1 egal Con^tanton. 

..JBSOAMLC. 

. -23*00 

flfi 5;;nfhiRVR ftasign_ _ ____ 

,„,BT06. 

...26.95 

1rt(;toFCf Ihn Mrv'-G»me ,... ,, 


.45.00 

iian end the Art df Besouce CiiUig.,,,.... ..... 

.-SZAAOre,.,,. 

.27,00 
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All entries in this index are alphabetized. For your convenience the product names 
are bold, book names are italicized and company names are in plain text. 


3D Graphics Pfogtamimyg Uaiig QuickDF&w 30,. 
3-D ScxjnP for WrtbQf fioatily/MuttimErSa __ 


. 29 

. 


AAA+ Software ...__ ____ .*,*.*, 

A Practk^ Guide to itm ........ 

Absoft Corporation........ 

Additional Ustings for Devefopment Enivironmeitte...i.i..i.tim... 

Adcfitional Listings for (^mem ---- 

Additional Listings for inWrw^ - 


.. 6 

. 21 

.3 


..19 

»n 


AdHiti<ififii LiRting^ for l .ibrarww ft ll1tiftl44rTi.inTTnTrT.Ti^m..r.T.«^T.T.i. 

...11 

Adlanta Inc............. ........... 

Cd(r nheAtocGtR,,,,,,.,.. . ,. ,,,, . 

..„...10 

.....,29 

AdveiFKxd Hemaker Pro 4.0 Deveioper Guido. ... 

AG Author, Inc, ......... ... 

_ 

Alrira Software, Inc......... 

.. 

...„.5 

Appie Enterprise Software ------—.. 

AffiipSrnpt Appk^tkwi' Btjdding Af^ w 

....X3 

AppieSorfit FindBf Qidfli Fhgfef? Dmipn 

. 

...28 

AppifiStWe fP. _, . -.-. . ..n. r, . , r M rn r. .-. - 

. 24 

AanieSnmt Lanounae Guidn _________ 

. .28 

AnfvMflker ^ 

Apprentice 7.,. -- -- ..- 

11 

AijHLnTmdk... . . ..... 

_Ifl 


Bara Bones Softwan;........... 

..a 10. 12 

BREdit LL..i|oim__ _j_ 1 ,J, -■I-Tinriiiiiiiiii 

a 12 

Be Dev^oper*s Guide........ 

... ...24 

Be. Inc............ ..... 

...a 

Beale Street GroLp, Ina ... __..............__ 

...15 


.a 

BeediiV^tafe, tnc............... 

... ..6.18 

BeatW^., .......... ......... 

.11 

BacHArtofMadntosh Gerrm /^nsgramming... 

....,29 

Blueworld Commjnicaiions....... 

__«..12 

Rowers Oi^ielcnrTVnt__________ 

. ....... .9 


C++ ProgfWTirfmg with Q^de^Vnambr., .... 

.. 

Captivate 4.6 Essential Graphics i .. 

...__.18 

Caiestin Company..... 

.11 

CGiiiv^iktt. .... 

_13 

Chril*7aTion“ 11,,.-.... .. ‘T-fn-r. 

^ . 1ft 

mipxrn- .... .. 

Ifl 

GodeBuilder............... 

.........5, a 

GnrIPiWflmnr rURrOvpr Prngrammmg Friitin. . . 

...Ji 

CodeWamorfor BeOS3..................... 

*^ 


DodeWamor for PatmPilot Roleasa 4.. 
CodaWanior LaUtude...................—— 


CodeWarrior Professional Release 2^ 


Code^^rrior Software Dev^opment Using Pomrpiant, 
Corik Graphics............ 


...27 
.9 


Discomnng CmStvSTef; Mard}.... ........... 

Qlscoverjng OPENSTB^ __ 

.......23 

.... 23 

flnflrript Plugin fnr Pilf^M^kpr Prn (Mar nnlyl. . 

.... ...a 

rhihe Niihem" 30,,. .... 

_ __ 1ft 

nvn»h/lnmh 1^_ ___ 

. ..._14 


-E— 

Effective C+r, Second &&ion ........ 

.. 24 

CDF Ctevefcpsr^ Gtidb trEOF2. JfMacft & Window^ __ 

for Marrintn^ . .n.rT-,. , 

______23 

— ___6 

FxeustiripPm 

..._IS 


—f— 


...Id 

FuUire Basic II.. 



GefljeWort<s, LLC,^«,«p,_-.. .. 7 

GeWng Hits- Jhe Defirwiw Qade To Promoting )tour --— 

miing Sa^ed Vm VmOtmn.. ........ 23 

GoUvs CybefSfur^ 2 tarMadotosh: \^sual QuickStaft Guide ..... ..20 

Guide Composer" __ 

HIM. Far Vm WtytfWi* vm. 2nd(jm)n ________ 

HIM. SrxwtXiiOOk a*bn......... 


imagna........ 

hcfoa^HitsandSe/lingMofBonycxjrWd)SitB.., 

hter^ce Design ....... 

Jasidia CodsW^rribr Professior^. .. 

ifisfcte Maoptosh; CD^HUM ........ 

Inside PowerP^l. ........ 


...f2 

....24 


...22 

...27 


Java OcEtfix/fBdf ... 

Jtswa rr a NutsheA 2nd E^Mion. .. 

__,...,20 

.......2S 

J^vsSOr^ L1 Oovddperls^ .—... 

....27 

jQvaScr^t hr tfm 

.... 28 

JavaScfpt ft Netscape tVS! 5 SirGfry...... 

...._..„,..,.25 

iRw-T7» 

... 26 
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^^ithout a daubU the Premiere Resource Editor 
for the Mae OS ... A wealth of time-saving tools.^ 


- Mac User Magazine Eddy Awards 

"A distimft improvement over Apple's ResEdit, 

- MacTeck Magazine 

""Every Mac OS developer should own a copy of Resorcerer ” 

- Li^mard Rosenthol, Aladdin Systems 

""Withoat Resorcerer^ our localization efforts would look like a ^ 

Tower of BabeL Don't do product without itF 

- Greg Galanos, CEO and President, Metrowerks 

""Resorcerer's data template system is amazing” 

-Bill Gm^dmun, author of Smaller Insiailer and Compact Pro 

'"Resorcerer Rocks! Buy it, you will NOT regret it” 

- Joe Zobkiw, author of A Fragment of Your Fmaginution 

""Resorcerer will pay for itself many times over in saved time and effort” 

- MacUser review 

""The template that disassembles "PICT's is awesomeT A 

- Bill Steinberg, author of Pyro! and PBlhols 

""Resorcerer proved indispensibie in its own creation!” 

- Doug McKenna, author ofResorcerer 



2 



Version 2.0 



• Very fast, HFS browser for viewing file tree of all voltimes 

• Extensibility for new Resorcerer Apprentices (CFM plugins) 

• New AppleScript Dictionary (‘aete") Apprentice Editor 

• MacOS 8 Appearance Manager-savvy Control Editor 

• PowerPlant text traits and menu command support 

• Complete AIFF sound file disassembly template 

• Big-j littlc-t and even mixed-endian template parsing 

• Auto-backup during file saves; folder attribute editing 

• Ships with PowerPC native, fat, and 68K versions 



Requires System 7.0 or greater, 
L5MB RAM, CD-ROM 


Standard price: $256 (decimal) 
Website price: $128 - $256 
(Educational, quantity, or 
other discounts available) 


• Fully supported; iCs easier, faster, and more productive than ResEdit 

• Safer memory-based, not disk-file-based, design and operation 

• All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and opens/marks/selects resources by text content 

• Makes global resource ID or type changes easily and safely 

• Builds resource files from simple Rez-like scripts 

• Most editors DeRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 

• Its own 32-bit List Mgr can open and edit ve^ large data structures 

• Templates can pre- and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp, QT, Balloons, ApplcEvent, GX, etc. 

• Full integrated support for editing color dialogs and menus 

• Try out balloons, ictb’s, lists and popups, even create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

A .A - ^ —A M j d. .h ^ m b . -d ifc . jUm /mt fa dk jFk OA ■ 4 p ■ ■■ adKi j^fa^dx lfa.«.k—k d-li I cd-a. j-b ^ wm. dP-l 1 jn. ^ j-h Mm l m « «k 


Includes: F/lectronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 


Payment: Check, PO's, or Visa/MC 
Taxes: Colorado customers only 


Extras (call, fax, or email us): 


iidiLLidia ^^43111, laA, unj 

COD, FedEx, UPS Blue/Red, 


International Shipping 


MATHEIVLESTHETICS, INC. 
PO Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440-0707 
Fax: (303) 440-0504 


• Editors for cursors, versions, pictures, bundles, and lots more 

• Relied on by thousands of Macintosh developers around the world 


rcsorcerer^mathem aesth eti cs. com 


Tb order by credit card, or to get the latest news, bug fixes, updates, and apprentices, visit our website^ 


www.mathemaesthetics.coin 













CodeWarrior 
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All rights reserved. All^iroducts are trademarks of their respective companies. 


flOD-3??-smh 
51S-a73-470a imetrowerks! 

WWW.metrowerks.com 


IT'S BIGGER, TOUGHER, PASTES 


CodeWarrior Pr'ofessionak Release 3. Just out 

and' ready for some s«riousi industrial-strength programming- 
Ue're still the codewriter's best friend and now we’re better 
than, ever- Here’s why! 

X Seamless integration of the Debugger into the IDE 
X Prerelease Jaya-to-Native Compiler for PowerPC and’x6b - 
XSupport. Tor* Af1D-3D’" Technology 

X Compare two folders graphically and merge ch.anges 

Sti.ll the only Integrated Development Environment that allows 
you to edit-i compile and debug Ci C + +-» Java and Pascal programs 
for multiple target processors and operating systems-yYou 
can count on the same world-class customer**support IDOiDQD 
programmers worldwide have grown to know and trust-" 

Codeldarrior* Professiona 1 Re^lease 3- Ue're poWe'r'fuli proveni 
easy-1 0 -hand1e and we've had all our shots- 












